Reddit Subreddit Details API

Q: Do I need a Reddit account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Reddit login or developer app is needed.

To get a subreddit's details and rules, call GET /v1/reddit/subreddit/details?subreddit=… with your API key. You get clean JSON back.

GET/v1/reddit/subreddit/details

curl "https://api.scraperize.com/v1/reddit/subreddit/details?subreddit=programming" \
  -H "x-api-key: YOUR_API_KEY"

Cost

1 credit / call

Only successful calls are charged. Errors are free.

Pagination

Single response

Everything comes back in one call.

Caching

0 credits

Set cache_max_age to reuse a recent result for free.

Rate limit

Per team / minute

Over the limit: 429 with a Retry-After header.

Parameters

subredditOptional

The subreddit's name, with or without r/. Required unless url is given.

urlOptional

The subreddit's URL, e.g. https://www.reddit.com/r/programming/. Required unless subreddit is given.

cache_max_ageOptional

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.

Send your key in the x-api-key header. Full API reference

Example response

200 OK · application/json

{
  "data": {
    "name": "programming",
    "id": "t5_2fwo",
    "url": "https://www.reddit.com/r/programming/",
    "title": "programming",
    "description": "Computer Programming",
    "iconUrl": "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=128&frame=1&auto=webp&s=400b33e7080a…",
    "bannerUrl": null,
    "createdAt": "2006-02-28T18:19:29.538Z",
    "type": "Public",
    "typeDescription": "Anyone can view, post, and comment to this community",
    "weeklyVisitors": 215933,
    "weeklyContributions": 1799,
    "membersName": null,
    "onlineName": null,
    "status": null,
    "bookmarks": [
      {
        "title": "FAQ",
        "url": "https://www.reddit.com/r/programming/wiki/faq"
      }
    ],
    "rules": [
      {
        "number": 1,
        "title": "No LLM-Written Content",
        "description": "If you don't want to write it, we don't want to read it. This includes the use of LLMs for translation or summarisation.…"
      }
    ],
    "isNsfw": false,
    "isQuarantined": false,
    "fetchedAt": "2026-11-06T12:48:59.559Z"
  },
  "meta": {
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "creditsCharged": 1,
    "creditsRemaining": 4999,
    "cached": false
  }
}

A real response, shortened to one item per list.

More Reddit endpoints

Subreddit Posts Subreddit Search Post Post Comments Post Transcript Search

FAQ

Reddit Subreddit Details API questions

How much does the Reddit Subreddit Details API cost?

1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.

Do I need a Reddit account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Reddit login or developer app is needed.

How fresh is the data?

Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.

Where are the full parameters and response fields?

In the API reference, with every parameter, field and error.

Try the Reddit Subreddit Details API

Grab your key and 100 free credits, no card required, and run this call in minutes.