Reddit

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, 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. upvote_ratio and subreddit_subscribers are currently null in post search results. To get upvote_ratio, pass the post URL to /v1/reddit/post; the ratio is returned at the top level.

get/v1/reddit/search

Request

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

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

trimboolean

Set to true for a trimmed down version of the response

afterstring

Used to paginate to next page

Response

Successful response

Changes