SCscrapecreators
Reddit

Subreddit Search

Searches within a specific subreddit for posts, comments, and media matching a query. Returns posts with title, votes, num_comments, url, and created_at; comments with author, body, votes, and parent post info; and media with title, media_type, image dimensions, and gallery_count. Supports sort, timeframe filtering, and cursor-based pagination.

get/v1/reddit/subreddit/search

Request

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

Query parameters

subredditstring required

Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)

querystring

Search query to find matching content

sort'relevance' | 'hot' | 'top' | 'new' | 'comments'

Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new

timeframe'all' | 'year' | 'month' | 'week' | 'day' | 'hour'

Timeframe to filter results

cursorstring

Cursor to get more results. Get 'cursor' from previous response.

Response

Successful response

Changes

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