List Requests

Fetch feature requests with filtering, pagination, and optional real-time scraping.

GET/api/v1/requests

List feature requests with pagination. Supports filtering by topic, platform, and category.

Query Parameters

NameTypeRequiredDescription
topicstringoptionalFilter by topic name (e.g., 'kanban', 'AI notetakers')
categorystringoptionalFilter by category slug
platformstringoptionalFilter by source platform (x, reddit, github, requesthunt)
limitnumberoptionalResults per page (1-100) (default: 20)
cursorstringoptionalPagination cursor from previous response
sourcestringoptionalData source (default: cached) (cached, realtime)

Notes

  • Use `source=realtime` to trigger live scraping from X, Reddit, and GitHub
  • Realtime requests count against your monthly realtime quota
  • Results are paginated - use the `cursor` from `meta` to fetch next page

Response Example

200 OK
{
  "data": [
    {
      "_id": "abc123",
      "title": "[Product] Add dark mode support",
      "description": "Users want a dark mode option...",
      "votes": 42,
      "commentCount": 5,
      "sourcePlatform": "reddit",
      "topic": "productivity",
      "authorName": "user123",
      "createdAt": 1702234567000
    }
  ],
  "meta": {
    "cursor": "eyJwb3NpdGlvbiI6...",
    "hasMore": true
  },
  "usage": {
    "cached": {
      "used": 10,
      "limit": 1000,
      "remaining": 990
    },
    "realtime": {
      "used": 2,
      "limit": 500,
      "remaining": 498
    }
  }
}