Skip to main content

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

Posts

Subreddits

Users

Pagination

All listing endpoints use cursor-based pagination with after and before parameters.
Pass the 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 with rs1.. 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 by new; 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 to subreddit, joined with +, for example subreddit=sales+startups+SaaS. Post search then sends Reddit this query:
Results stay inside the listed subreddits. You can also write the same 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 returns 422 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:
With a short keyword list and typical subreddit names, about 10 subreddits fit in one request. Split longer lists across several requests and merge the results by post 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

When is_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.
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:
An async call is billed once, when it completes. See Async requests and webhooks for webhooks, signatures and the SDK helpers.
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.