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
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 endpoint across all 1 revision of this API.