Getting started

Pagination

List endpoints use opaque cursor pagination. The first request omits the cursor; subsequent requests pass meta.page.next_cursor from the previous response.

Flow

# Page 1
curl https://api.redditintel.dev/v1/subreddits/python/posts?limit=25 \
  -H "Authorization: Bearer <YOUR_API_KEY>"

# response →
{
  "data": [ ... 25 posts ... ],
  "meta": {
    "request_id": "...",
    "page": { "next_cursor": "abc.signature" }
  }
}

# Page 2
curl https://api.redditintel.dev/v1/subreddits/python/posts?limit=25&cursor=abc.signature \
  -H "Authorization: Bearer <YOUR_API_KEY>"

When next_cursor is null, you've reached the end.

Cursor scope

Cursors are signed and typed. A cursor from /v1/subreddits/python/posts cannot be used on /v1/users/spez/posts. Mixing cursor types, tampering with the token, or passing an expired one returns:

{
  "error": {
    "code": "INVALID_CURSOR",
    "message": "cursor is missing, malformed, expired, or signed for a different route",
    "request_id": "<redacted>"
  }
}

Limit parameter

limitNumber of items per page. Defaults to 25. Maximum is the lower of the endpoint cap (typically 100) and your plan's max_page_size.
limit > maxReturns 400 BAD_REQUEST. The API does not silently truncate.

← Previous

Response envelope

Rate limits