Playground Sign in Start free
Social and video · reddit.com

How to scrape Reddit

Reddit (reddit.com) is a social platform. This guide is built from our own checks of its public pages: what the pages contain, whether our requests get through right now, and the request settings that worked.

Mostly working

10 of 17 of our checks passed in the last 7 days (58.8%).

Last check 2026-11-02 17:43 UTC · last pass 2026-11-02 14:04 UTC · checked with our own requests, never customer data.

Try it in the Playground

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

What you can get

The API returns the rendered HTML of the page. Select the fields you need with extract rules (CSS selectors) or parse the HTML on your side.

Public pages Mostly working

Page types we check: Public pages, Detail pages.

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page, prints the start of the page, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

No extraction recipe for these pages yet: the script fetches the page with the working settings. Add extract rules to get JSON.

reddit_page_sdk.py pip install ujeebu-python==0.1.5
# Fetch a Reddit page with the Ujeebu Scrape API.
# Settings from our health checks (Ujeebu site guide). Prints the start of the page HTML.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 reddit_page_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.reddit.com/r/technology/",
]
SETTINGS = {
    "js": True,
    "scroll_down": True,
}


def scrape(client, url):
    try:
        response = client.scrape(url, params=SETTINGS)
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.text


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    html = scrape(client, url)
    print(len(html), "bytes")
    print(html[:500])

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/reddit.json.

Try it yourself

Run this on Reddit with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
scroll_downtrue
Costup to 5 credits a request (only HTTP 200 and 404 are billed)
Learnedjs + scroll (found by our retry layer)

Pages of this site show a CAPTCHA. Our checks with auto_captcha_solve did not get past it (solved in 0 of 3 checks over the last 30 days), so these settings leave it out.

Our engineers are looking at this site.

Each public page is one request: change the path in the URL to fetch another one. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on.

Try it in the Playground

Troubleshooting

The failures our own checks of reddit.com ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
The site blocked the request (HTTP 403 or a block page) 21 None of the settings we tried got past it in 7 days.
A captcha page instead of the content 19 The CAPTCHA solver (auto_captcha_solve) did not get the page in 3 checks over 30 days, and nothing else we tried got past it in 7 days.

A failed request is not billed: only HTTP 200 and 404 responses cost credits.

What people build with Reddit data

  • Market researchFollow public company pages and job postings to see who grows and hires.More on this use case

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of www.reddit.com (read 2026-10-27): public pages asked to stay away (Disallow: /); no crawl delay set.
  • Read Reddit's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Reddit with Ujeebu?

Partly. 10 of 17 checks of public Reddit pages passed in the last 7 days; most failures were the site blocked the request (HTTP 403 or a block page). Retry failed pages later, and use the settings on this page.

Which settings work for Reddit?

Call /scrape with js=true, scroll_down=true. Our retry layer found that this site needs "js + scroll".

How many credits does a Reddit request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Is it allowed to scrape Reddit?

Its robots.txt asks generic crawlers to stay away from public pages (Disallow: /). Collect public pages only, read Reddit's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of reddit.com, which run around the clock. Last check: 2026-11-02 17:43:23 UTC; last pass: 2026-11-02 14:04:56 UTC.