Reddit Scraper API endpoints

This guide shows you how to send a synchronous request to each Bright Data Reddit Scraper API endpoint. It covers collecting posts, discovering posts and collecting comments.

Prerequisites

A Bright Data account with an active API key
Completed the Quickstart

Request structure

Every synchronous request follows the same pattern:

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.reddit.com/..."}]

The only things that change between endpoints are the dataset_id and the input shape.

The /scrape endpoint is built for real-time, single-URL requests. It accepts up to 20 URLs and waits up to 1 minute. If collection takes longer, the response is HTTP 202 with a snapshot_id instead of data, and collection continues asynchronously. Fetch the result with async requests or have it pushed to you with webhook delivery.

Posts, Collect by URL

Scrape a specific Reddit post by its URL. Dataset ID: gd_lvz8ah06191smkebj4

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}]'

import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}],
)

print(response.json())

const response = await fetch(
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/" }
    ]),
  }
);

const data = await response.json();
console.log(data);

You should see a 200 response. Processing time varies with target-site conditions and scraper workload.

Example response

[
  {
    "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?",
    "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...",
    "num_upvotes": 8,
    "num_comments": 14,
    "date_posted": "2026-09-05T21:03:33.625Z",
    "tag": null,
    "community_name": "learnpython"
  }
]

Full Posts - Collect by URL schema

Posts, Discover by subreddit URL

Scrape recent posts from a specific subreddit, optionally sorted with sort_by. Values are case-sensitive and match the labels on Reddit, for example Hot. Lowercase hot is rejected with a validation error. Dataset ID: gd_lvz8ah06191smkebj4

Discovery endpoints are best used asynchronously via /trigger since they may return many results. The sync example below is for quick testing.

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "Hot"}]'

import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={
        "dataset_id": "gd_lvz8ah06191smkebj4",
        "format": "json",
        "type": "discover_new",
        "discover_by": "subreddit_url",
    },
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "Hot"}],
)

print(response.json())

const response = await fetch(
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://www.reddit.com/r/learnpython/", sort_by: "Hot" }
    ]),
  }
);

const data = await response.json();
console.log(data);

Full Discover by subreddit URL schema

Posts, Discover by keyword

Find Reddit posts matching a search term, filtered by date. Dataset ID: gd_lvz8ah06191smkebj4

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}]'

import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={
        "dataset_id": "gd_lvz8ah06191smkebj4",
        "format": "json",
        "type": "discover_new",
        "discover_by": "keyword",
    },
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}],
)

print(response.json())

const response = await fetch(
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { keyword: "machine learning", date: "Past week", num_of_posts: 20 }
    ]),
  }
);

const data = await response.json();
console.log(data);

Full Discover by keyword schema

Comments, Collect by URL

Scrape all comments from a Reddit post or a specific comment thread, with optional filtering by age. Dataset ID: gd_lvzdpsdlw09j6t702

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", "days_back": 7}]'

import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "gd_lvzdpsdlw09j6t702", "format": "json"},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json=[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", "days_back": 7}],
)

print(response.json())

const response = await fetch(
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", days_back: 7 }
    ]),
  }
);

const data = await response.json();
console.log(data);

Example response

[
  {
    "comment_id": "p841ojc",
    "user_posted": "rec***e",
    "comment": "[List\\_comprehension](https://en.wikipedia.org/wiki/List_comprehension) have an interesting history. It use in functional programming language which python a...",
    "date_posted": "2026-09-06T05:58:16.000Z",
    "num_upvotes": 1,
    "num_replies": 0,
    "replies": null,
    "post_url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
    "post_id": "1w8chn8",
    "post_type": null
  }
]

Full Comments - Collect by URL schema

Async batch requests

Scrape thousands of posts or run keyword discovery jobs in a single async request.

API reference

Full endpoint specs, parameters and response schemas.

Get started

Data extraction

AI training data

Proxy networks

Prerequisites

Request structure

Posts, Collect by URL

Posts, Discover by subreddit URL

Posts, Discover by keyword

Comments, Collect by URL

Async batch requests

API reference

​Prerequisites

​Request structure

​Posts, Collect by URL

​Posts, Discover by subreddit URL

​Posts, Discover by keyword

​Comments, Collect by URL

​Related

Async batch requests

API reference

Prerequisites

Request structure

Posts, Collect by URL

Posts, Discover by subreddit URL

Posts, Discover by keyword

Comments, Collect by URL

Related