Skip to main content
RequestHuntRequestHunt

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
platformsstringoptionalComma-separated source platforms to filter by (x, reddit, github, youtube, linkedin, amazon)
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
  • Cached reads (default) are free and do not consume credits — only rate-limited
  • Realtime requests (`source=realtime`) consume credits from your unified monthly pool
  • 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": {
    "credits": {
      "used": 12,
      "limit": 100,
      "remaining": 88
    }
  }
}