Scraper API for Reddit
Search posts, fetch comment trees, explore subreddits, and retrieve user profiles from Reddit. The API handles TLS fingerprinting, proxy rotation, and anti-bot bypass automatically — no Reddit API key or OAuth setup needed.Key Features
22 Endpoints
Search, posts, comments, subreddits, users, wiki, trending, and cross-post detection.
No Reddit API Key
We handle all authentication and rate limiting. Just use your ScrapeBadger API key.
Comment Trees
Full nested comment threads with configurable depth control (0-10 levels).
Search Syntax
Full Reddit search operators: title:, author:, subreddit:, flair:, AND/OR/NOT.
Anti-Bot Bypass
Automatic TLS fingerprint rotation and residential proxy routing.
SDK Support
First-class support via the ScrapeBadger Node.js and Python SDKs.
Quick Start
Endpoints
Search
Posts
Subreddits
Users
Pagination
All listing endpoints use cursor-based pagination withafter and before parameters.
after value as a query parameter to get the next page of results. The maximum limit per request is 100.
Search pagination
Post, community, and user search return Reddit’s current web search results in the order Reddit provides them. Community and user search support pagination beyond the first matches. Search cursors start withrs1.. Treat them as opaque: pass pagination.after unchanged with the same query, subreddit scope, sort, and time filter. They expire after 30 minutes. An invalid, expired, or mismatched cursor returns 422; restart the search without after.
limit is the maximum number of results to return. Reddit’s native page may contain fewer rows. Keep paginating while pagination.after is present, even when count is smaller than limit. Search pagination moves forward only; pagination.before is null.
Community search includes weekly_visitors and weekly_contributions when Reddit supplies them. These activity counters are separate from subscribers. Post search can include search_snippet, the excerpt shown in search results; selftext remains the full post body when available.
Search time filters
Search follows Reddit’s UI behavior. Reddit ignores the time filter when sorting bynew; results can be older than the requested window. Use top, hot, or comments when you need a time window.
Search Syntax
The search endpoints support Reddit’s full query syntax:Searching several subreddits
Pass several subreddits tosubreddit, joined with +, for example subreddit=sales+startups+SaaS. Post search then sends Reddit this query:
subreddit: filters into q yourself.
To list the newest posts from several subreddits without a keyword, use GET /v1/reddit/subreddits/sales+startups+SaaS/posts?sort=new and filter the posts on your side.
Query length limit
Reddit search reads only the first 256 bytes (UTF-8) of a query and silently ignores the rest. A query over 256 bytes returns422 instead of incomplete results. Most characters are 1 byte; accented and non-Latin characters take 2 to 4.
With several subreddits, the whole combined query counts, so each subreddit uses 14 bytes plus the length of its name:
id.
Response Fields
These tables list every field the API returns. Fields Reddit only populates
for the account that owns the content (
saved, clicked, likes, …) and
moderator-only fields are deliberately omitted — they are meaningless for a
scraping API.Post Object
Comment Object
Subreddit Object
User Object
Post images
Reddit stores a post’s images in two different places depending on the post type, so ScrapeBadger surfaces both.Galleries
Whenis_gallery is true, every image is listed in gallery_images in the
order the poster arranged them, at full source resolution. Deleted or
still-processing slots are omitted.
A gallery post’s
url points at reddit.com/gallery/<id> and its thumbnail
is only ~140px wide. Use gallery_images for the actual images.Single image, video and link posts
thumbnail is at most ~140px wide. For the full-size image:
preview.redd.it and external-preview.redd.it URLs are signed. Use them
exactly as returned — changing width/height, or stripping or re-ordering
the query string, invalidates the signature and Reddit answers 403.Rate Limits
Reddit Scraper API requests are subject to the same rate limits as all ScrapeBadger endpoints. See Rate Limits for details.Run this asynchronously
Calls on this API can run in the background, so you don’t hold a connection open while they work. Add one of these to the call:ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by Reddit. “Reddit” is a trademark of Reddit, Inc., used here only to describe the platform this scraper is designed to work with.

