Reddit Scraper
Get 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.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| subredditstring · required | string | required | Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL) |
| sortstring · optional | string | optional | Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new One of: |
| 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; use the returned cursor for the next batch. The price is the same either way. |
| querystring · optional | string | optional | Search query to find matching content |
| cursorstring · optional | string | optional | Cursor to get more results. Get 'cursor' from previous response. |
| timeframestring · optional | string | optional | Timeframe to filter results One of: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"media": {
"type": "array"
},
"posts": {
"type": "array"
},
"cursor": {
"type": "string"
},
"comments": {
"type": "array"
},
"limitApplied": {
"type": "boolean",
"description": "True when a Limit trimmed the results; there were more in this response."
}
},
"additionalProperties": true
}
