Reddit Scrape
Reddit Data & Analytics API Real-time and historical Reddit data — posts, comments, user profiles, media, awards, subreddit metadata, and full-text search. Continuously updated by background workers and enriched with structured data you won't get from Reddit's native API responses. --- Why This API? Reddit's official API is rate-limited, requires OAuth setup, and returns raw unstructured JSON…
Reddit Scrape endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
Health Check /api/v1/health |
Returns system health status including worker activity, rate limit state, data counts, database sizes, and last sync timestamp. Use this to monitor API availability and data… |
| GET |
List Posts /api/v1/posts |
List Reddit posts with filtering by subreddit, author, and minimum score. Supports sorting by score, date, or comment count. Paginated. Returns cached data instantly; if no local… |
| GET |
Search Posts /api/v1/posts/search |
Full-text search across all post titles and content using FTS5. If no local results, automatically searches Reddit and returns fresh results. Paginated. |
| GET |
Post Statistics /api/v1/posts/stats |
Aggregate statistics for collected posts: total count, average score, maximum score, and average comment count. Optionally filter by subreddit. USES local data inside of our own… |
| GET |
Top Posts /api/v1/posts/top |
Get the highest-scoring posts within a time window. Filter by subreddit and time range (hour, day, week, month, year, all). Falls back to Reddit if no local results. |
| GET |
Posts With Media /api/v1/posts/media |
List posts that contain media (images, videos, galleries). Filter by subreddit and media type. Returns posts that have extracted media URLs with dimensions |
| GET |
Get Post By ID /api/v1/posts/{post_id} |
Get a single Reddit post by its ID. Returns cached data instantly if available. If not in local database, fetches from Reddit in real-time, caches it, then returns it. |
| GET |
Get Post Media /api/v1/posts/{post_id}/media |
Get all extracted media URLs for a specific post. Returns images, videos, gallery items, and thumbnails with width, height, and media type. |
| GET |
Get Post Awards /api/v1/posts/{post_id}/awards |
Get the award breakdown for a specific post. Returns each award name, count, icon URL, and description |
| GET |
Get Comments For Post /api/v1/comments/{post_id} |
Get the full comment tree for a Reddit post. Sortable by score, date, or depth. Returns cached comments instantly; if none exist locally, fetches the full comment tree from Reddit. |
| GET |
Search Comments /api/v1/comments/search |
Full-text search across all collected comment bodies. Local data only. Paginated. |
| GET |
Comment Statistics /api/v1/comments/stats |
Aggregate statistics for collected comments: total count, average score, and maximum score. Optionally filter by subreddit. Returns aggregate statistics over all collected data.… |
| GET |
Get Comment Awards /api/v1/comments/awards/{comment_id} |
Get the award breakdown for a specific comment. Returns each award name, count, icon URL, and description. |
| GET |
List Users /api/v1/users |
List collected Reddit user profiles. Sortable by total karma, link karma, comment karma, or account creation date. Paginated. |
| GET |
Search Users /api/v1/users/search |
Full-text search across collected user profiles by username and description. Local data only. Paginated. |
| GET |
Get User Profile /api/v1/users/{username} |
Get a Reddit user's full profile including karma breakdown, account age, verification status, avatar, and bio. Returns cached data if available; otherwise fetches from Reddit,… |
| GET |
List Subreddits /api/v1/subreddits |
List all tracked subreddits with full metadata including subscriber count, description, content policies, and visual assets. Local data only. Paginated. |
| GET |
Get Subreddit /api/v1/subreddits/{name} |
Get full metadata for a specific subreddit. Returns cached data if available; otherwise fetches from Reddit, caches it, then returns it. Includes subscriber count, description,… |
| GET |
Get Subreddit Rules /api/v1/subreddits/{name}/rules |
Get the posting rules for a specific subreddit. Returns cached rules if available; otherwise fetches from Reddit. Each rule includes the short name, description, violation… |
| GET |
Get Watchlist /api/v1/subreddits/watchlist |
Get the list of subreddits currently being tracked by background workers. These subreddits have their posts, comments, and metadata collected automatically on a schedule. (add to… |
| POST |
Add To Watchlist /api/v1/subreddits/watchlist |
Add a subreddit to the tracking watchlist. Once added, background workers will automatically collect new posts, top posts, comments, and metadata on a schedule. Returns 409 if… |
| POST |
Enqueue Search /api/v1/search |
Queue a Reddit search job for background processing. The search runs asynchronously and results can be retrieved via GET /search/{id}. Useful for large or complex searches. |
| GET |
Get Search Results /api/v1/search/{query_id} |
Retrieve results from a previously queued search job. Returns the original query parameters and all matched posts. Returns 404 if the query ID doesn't exist. |
| GET |
Local Search /api/v1/search/local |
Instant full-text search across all cached posts. If no local results are found, automatically falls back to searching Reddit and returns fresh results. Best for quick lookups. |