Reddit Scraper
Search 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, 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.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| querystring · required | string | required | Search query |
| sortstring · optional | string | optional | Sort by. Comment search supports relevance, new, and top; comment_count is for post search only. One of: |
| trimboolean · optional | boolean | optional | Set to true for a trimmed down version of the response |
| afterstring · optional | string | optional | Used to paginate to next page |
| limitnumber · optional | number | optional | Maximum number of results to return from this request. Leave empty for everything this request returns. This trims the response — it does not fetch more. The price is the same either way. |
| filterstring · optional | string | optional | Search posts or comments One of: |
| timeframestring · optional | string | optional | Post search timeframe One of: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"after": {
"type": "string"
},
"posts": {
"type": "array"
},
"limitApplied": {
"type": "boolean",
"description": "True when a Limit trimmed the results; there were more in this response."
}
},
"additionalProperties": true
}