Reddit

Reddit Subreddit Post Search API

Search posts inside one subreddit — not subreddit discovery.

Search posts inside one subreddit (r/name + q). This is not subreddit discovery — results are the same post shape as site-wide /reddit/search (score, not an upvotes twin; crosspostOf / duplicateOfId; name is t3_ + id), restricted to that community. Same sort (relevance/new/top/hot/comments), timeframe, cursor pagination and null card-only fields (text, upvoteRatio, flair …) as site-wide Search. A legitimate empty page is 200 results:[]. An upstream miss is 503 UPSTREAM_UNAVAILABLE (retryable, Retry-After) at 0 credits. Flat 2 credits.

Docs: https://captapi.com/apis/reddit-subreddit-search

get/v1/reddit/subreddit-search

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/reddit/subreddit-search
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring required

Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.

qstring required

Keywords or search query (min 2 characters).

limitinteger

Max items to return (default 25, max 200). Flat 2 credits per call.

sortstring

relevance (default) | new | top | hot | comments (alias: comment_count).

timeframestring

For sort=top or comments: hour | day | week | month | year | all (default all).

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.

cacheboolean

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.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.