Reddit Scraper API

Send a Reddit URL or a keyword, get structured JSON back. The Bright Data Reddit Scraper API handles proxies, CAPTCHAs and parsing so you can focus on your data pipeline.

New to Bright Data? Create a free account and get 5,000 free credits every month, no credit card required. That’s up to 5,000 Reddit records to start scraping. See the free tier.

How it works

You send one or more Reddit URLs or keywords to the Bright Data Reddit Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY

All requests use a dataset_id to specify the data type (posts or comments) and return results in JSON, NDJSON or CSV.

What the response looks like

A single record returned by the Bright Data Reddit Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the quickstart.

{
  "post_id": "t3_1w8chn8",
  "url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
  "user_posted": "xq_***x",
  "title": "found a for loop and can't find an explanation. Can someone explain, please?",
  "num_upvotes": 8,
  "num_comments": 14,
  "date_posted": "2026-09-05T21:03:33.625Z",
  "community_name": "learnpython",
  "community_members_num": 1053086,
  "description": "Hey there, I just started the Project Euler Archive and started with the classic \"Find the sum of all the multiples of 3 or 5 below 1000.\" And when I wanted..."
}

Supported data types

Posts

Titles, descriptions, upvotes, community stats and attached media. Collect by post URL or discover by keyword or subreddit URL.

Comments

Comment text, replies, upvotes and post context. Collect by post or comment URL, with optional day-based filtering.

Which endpoints are available

The Reddit Scraper API exposes two dataset families. Each family supports one or more input shapes.

Dataset	Input	What it returns
Posts, Collect by URL (`gd_lvz8ah06191smkebj4`)	`url` (post URL)	A single post with metadata, community info and media
Posts, Discover by keyword (`gd_lvz8ah06191smkebj4`)	`keyword`, `date`, `num_of_posts`	Posts matching a search term, filtered by date
Posts, Discover by subreddit URL (`gd_lvz8ah06191smkebj4`)	`url` (subreddit URL), `sort_by`	Posts from one subreddit, sorted by `new`, `top` or `hot`
Comments, Collect by URL (`gd_lvzdpsdlw09j6t702`)	`url` (post or comment URL), `days_back`	Comments from a post with full thread context

Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

Method	Endpoint	Best for
Synchronous	`/scrape`	Real-time lookups, up to 20 URLs
Asynchronous	`/trigger`	Batch jobs, 20 or more URLs, production pipelines

Learn more in Understanding sync vs. async requests. Both endpoints accept the inputs as a bare JSON array, which is what every example on this page uses, or as an object with an input array. Use the object form when you also send custom_output_fields or limit_per_input on either endpoint, or a deliver block on /trigger. See Request body.

Capabilities and limits

Capability	Detail
Output formats	JSON, NDJSON, CSV
Max URLs per sync request	20
Max URLs per async request	Unlimited, up to 1 GB of input per job
Data freshness	Real-time (scraped on demand)
Delivery options	API download, webhook, Amazon S3, Snowflake, Azure, GCS (all destinations)
Pricing	Pay per successful record (see pricing)

Common questions

Is the data scraped in real time?

Yes. Each request triggers a live scrape against Reddit. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Reddit Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP 202 with a snapshot_id and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

Why do response times change over time?

Reddit changes how its pages are served, and the Bright Data Reddit Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the async workflow or webhook delivery so a longer run does not break the integration.

What is the difference between Collect and Discover?

Collect by URL scrapes a specific Reddit page you provide, a single post, a comment thread or a subreddit. Discover finds Reddit posts matching search criteria such as a keyword or a subreddit listing, then scrapes the results. Discovery is most useful via async requests when you don’t know the exact URLs up front.

Can I collect only recent comments from a post?

Yes. The Comments API accepts an optional days_back parameter. Pass an integer to limit results to comments posted within that many days.

How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

Next steps

Quickstart

Scrape your first Reddit post in 5 minutes.

Endpoints

One request per endpoint, each with a captured response.

API reference

Endpoint specs, parameters and response schemas.

Get started

Data extraction

AI training data

Proxy networks

How it works

What the response looks like

Supported data types

Posts

Comments

Which endpoints are available

Request methods

Capabilities and limits

Common questions

Is the data scraped in real time?

Why do response times change over time?

What is the difference between Collect and Discover?

Can I collect only recent comments from a post?

How is this different from scraping using proxies or Web Unlocker API?

Next steps

Quickstart

Endpoints

API reference

​How it works

​What the response looks like

​Supported data types

Posts

Comments

​Which endpoints are available

​Request methods

​Capabilities and limits

​Common questions

​Is the data scraped in real time?

​Why do response times change over time?

​What is the difference between Collect and Discover?

​Can I collect only recent comments from a post?

​How is this different from scraping using proxies or Web Unlocker API?

​Next steps

Quickstart

Endpoints

API reference

How it works

What the response looks like

Supported data types

Which endpoints are available

Request methods

Capabilities and limits

Common questions

Is the data scraped in real time?

Why do response times change over time?

What is the difference between Collect and Discover?

Can I collect only recent comments from a post?

How is this different from scraping using proxies or Web Unlocker API?

Next steps