Reddit Search API
Reddit site-wide post search — sort + timeframe + cursor, score/upvoteRatio, authorFullname.
Pass a keyword and get matching public posts across Reddit as clean JSON. Sort with sort=relevance|new|top|hot|comments (alias comment_count); for top/comments use timeframe=hour|day|week|month|year|all (default all). The response echoes sort and timeframe. Each result includes id, name (always "t3_" + id), title, url, subreddit, author + authorFullname (t2_…), score, comments, ISO publishedAt, nsfw, crosspostOf and duplicateOfId (first same-author+title row on this page, else null). Reddit's search page shows a result card, not the post body, so text, upvoteRatio, scoreHidden, flair, isVideo, thumbnail and subscriberCount are null — call Post Details for the full post. Reddit's search returns 7–25 posts per page; one call chains up to three pages to reach limit, and nextCursor (an opaque string) resumes exactly where the response stopped. Cursors issued before 14 Oct 2026 are rejected with 400 INVALID_CURSOR. This endpoint returns posts only — not a comments[] or media[] search surface. A miss is 503 UPSTREAM_UNAVAILABLE at 0 credits. Flat 2 credits. Pass cache=true for the 24h shared cache.
Request
- Base URL: https://api.captapi.com
- URL: https://api.captapi.com/v1/reddit/search
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
Keyword or phrase to search Reddit posts site-wide (min 2 characters).
Max items to return (default 25, max 200). Flat 2 credits per call.
relevance (default) | new | top | hot | comments (alias: comment_count).
For sort=top or comments: hour | day | week | month | year | all (default all).
Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Response
Success. The data object for this endpoint.
Changes
No recorded changes to this operation across all 3 revisions of this API.