Reddit

Search

Searches across all of Reddit for posts or comments matching a query. Set filter to posts (the default) or comments. Post results include title, author, selftext, subreddit, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, and is_video. Comment results include the matching body, author, votes, timestamps, comment URL, parent relationship, and post/subreddit context. Comment searches support relevance, new, and top sorting. Timeframe filtering applies to post searches. Pagination uses the after token, and trim returns a lighter response.

get/v1/reddit/search

Query parameters

querystring required

Search query

filter'posts' | 'comments'

Search posts or comments

sort'relevance' | 'new' | 'top' | 'comment_count'

Sort by. Comment search supports relevance, new, and top; comment_count is for post search only.

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

Post search timeframe

afterstring

Used to paginate to next page

trimboolean

Set to true for a trimmed down version of the response

Response

Successful response

Changes

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