Reddit

Subreddit search

Search post, comment and media sections together or choose the sections to retrieve, with independent continuation for each selected section and optional exact matching. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/reddit/subreddit/search

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/reddit/subreddit/search
  • Auth: API key in header x-api-key

Query parameters

subredditstring required
querystring
sort'relevance' | 'hot' | 'top' | 'new' | 'comments'
timeframe'all' | 'year' | 'month' | 'week' | 'day' | 'hour'
cursorstring
sections'posts' | 'comments' | 'media' | 'posts,comments' | 'posts,media' | 'comments,media' | 'posts,comments,media'

Comma-separated selection: posts, comments, media, posts,comments, posts,media, comments,media, or posts,comments,media (default). Keep the same selection when continuing.

number
OR
string

Earliest publication time to include, as ISO 8601 (2026-09-27T09:00:00Z) or Unix seconds. With sort=new, pagination ends once results are older than since.

number
OR
string

Publication time to stop before, as ISO 8601 or Unix seconds; must be later than since.

boolean
OR
'true' | 'false'

true keeps only results whose own text contains every query word or "quoted phrase" as a whole word (case- and accent-insensitive; A OR B and -word are honoured); defaults to false.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.