> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Reddit Subreddit Info Details

Structured Reddit data: send `subreddits`. Single lookup, 1 credit per successful call.

`GET|POST https://api.scrapier.io/api/v2/reddit-subreddit-info-details/` · 1 credit per successful call · Single lookup

## Overview

Call `GET /api/v2/reddit-subreddit-info-details/` with `subreddits`. The results are in `data.subreddit`. 2 optional parameters refine the call (see Parameters).

## Request

```bash
curl -G "https://api.scrapier.io/api/v2/reddit-subreddit-info-details/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "subreddits=AskReddit" \
  --max-time 210
```

```python
import requests

resp = requests.get(
    "https://api.scrapier.io/api/v2/reddit-subreddit-info-details/",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"subreddits": "AskReddit"},
    timeout=210,
)
body = resp.json()
if not resp.ok:
    raise RuntimeError(body.get("error") or body.get("detail"))

print(body["data"]["subreddit"])
```

POST with a JSON body works too (same parameters; the body is merged over the query string).

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `X-API-Key` (header) | string | yes | — | Your API key. |
| `subreddits` | string | yes | e.g. `AskReddit` | Subreddit name ("AskReddit", "r/AskReddit" - any casing) or a subreddit URL (www./old./new./np. hosts) -> ONE full detail record (subreddit_id, display_name, title, subscribers, weekly_active_users, weekly_contributions, description, created_at, rules, icon / banner URLs, is_nsfw, subreddit_type, language ...). Single lookup: next_cursor is always null. An unknown / private / banned / quarantined subreddit answers a status record (not_found \| private \| banned \| quarantined \| gold_only). |
| `cursor` | string | no | — | Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. |
| `fetch_page` | boolean | no | `true` | true (default) = also load the reddit.com community page for the web-only leaves (weekly_active_users, weekly_contributions, ms-precise created_at, web image variants, community_status). false = API only. Locked in cursor. |
| `use_proxy` | boolean | no | `true` | Route the request through Scrapier's residential proxy pool. Default: `true`. Leave as is unless support tells you otherwise. |
| `raw_data` | boolean | no | `false` | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. |

## Response

HTTP 200. Results are in `data.subreddit`. Sample from the live catalog, arrays trimmed to 3 items.

```json
{
  "success": true,
  "data": {
    "subreddits": "AskReddit",
    "subreddit": {
      "input_subreddit": "AskReddit",
      "subreddit": "AskReddit",
      "status": "ok",
      "note": null,
      "http_status": 200,
      "subreddit_id": "t5_2qh1i",
      "display_name": "AskReddit",
      "weekly_active_users": 15517795,
      "weekly_contributions": 1139301,
      "rules": "1 Rule 1 - Questions must be clear and direct and may not use the body textbox All questions must be clear, written in English, and conclude with a question mar ...",
      "description": "r/AskReddit is the place to ask and answer thought-provoking questions.",
      "header_img": "https://styles.redditmedia.com/t5_2qh1i/styles/bannerBackgroundImage_fs33xogq946f1.png?frame=1&auto=webp&s=9170912bc2b0276e17131afc71ba890709183f10",
      "icon_img": "https://styles.redditmedia.com/t5_2qh1i/styles/communityIcon_p6kb2m6b185b1.png?width=128&frame=1&auto=webp&s=1124511c3a95cc4ec094a4e8886de1e08a0f1e0a",
      "subscribers": 59684848,
      "advertiser_category": "Lifestyles",
      "created_at": "2008-01-25T03:52:15.108Z",
      "submit_text": "**AskReddit is all about DISCUSSION. Your post needs to inspire discussion, ask an open-ended question that prompts redditors to share ideas or opinions.**\n\n**Q ...",
      "verified": true,
      "following": null,
      "posts_count": null,
      "likes_count": null,
      "url": "https://www.reddit.com/r/AskReddit",
      "private": false,
      "is_nsfw": false,
      "language": "es",
      "engagement_rate": 0.0734,
      "content_category": "lifestyles",
      "estimated_reach": 15517795,
      "title": "Ask Reddit...",
      "subreddit_type": "public",
      "quarantine": false,
      "community_status": "Credit",
      "community_status_icon": "https://emoji.redditmedia.com/5atpv9pyenjf1_t5_2qh1i/donkey_right",
      "header_title": "Ass Credit",
      "description_markdown": "###### [ [ SERIOUS ] ](http://www.reddit.com/r/askreddit/submit?selftext=true&title=%5BSerious%5D)\r\n\r\n\r\n##### [Rules](https://www.reddit.com/r/AskReddit/wiki/in ...",
      "submit_text_label": "Ask a question",
      "submission_type": "self",
      "primary_color": "#d4eaff",
      "key_color": "#222222",
      "banner_background_color": "#d4eaff",
      "community_icon": "https://styles.redditmedia.com/t5_2qh1i/styles/communityIcon_p6kb2m6b185b1.png?width=256&s=c28b9f038c305e139b62739f2133d7b776582696",
      "banner_background_image": "https://styles.redditmedia.com/t5_2qh1i/styles/bannerBackgroundImage_fs33xogq946f1.png?width=4000&s=460f7387ea96fb4707fad8acaa81643df40f19a9",
      "mobile_banner_image": "https://styles.redditmedia.com/t5_2qh1i/styles/bannerBackgroundImage_fs33xogq946f1.png?width=1448&frame=1&auto=webp&s=46aec25486105b841bc0743d9ef2b9c8d9b65900",
      "allow_images": false,
      "allow_videos": false,
      "allow_galleries": false,
      "allow_polls": false,
      "spoilers_enabled": true,
      "wiki_enabled": true,
      "restrict_posting": true,
      "restrict_commenting": false,
      "accept_followers": true,
      "whitelist_status": 6,
      "rules_count": 12,
      "rules_list": [
        {
          "number": 1,
          "short_name": "Rule 1 - Questions must be clear and direct and may not use the body textbox",
          "description": "* All questions must be clear, written in English, and conclude with a question mark\n* All context in the title must be  ...",
          "kind": "link",
          "violation_reason": "Rule 1 - Questions must be clear and direct and may not use the body textbox",
          "priority": 0,
          "created_at": "2022-05-19T20:49:43Z"
        },
        {
          "number": 2,
          "short_name": "Rule 2 - No personal or professional advice requests",
          "...": "(same shape; 12 rules in total)"
        }
      ],
      "warnings": [],
      "stats": {
        "requests": 4,
        "api_calls": 2,
        "page_loads": 2,
        "challenges_solved": 1,
        "walls_by_fingerprint": {},
        "rate_limited": 0,
        "api_ratelimit_remaining": "19.0",
        "token_source": "accounts.reddit.com/web",
        "proxy": false,
        "page_source": "reddit.com page",
        "rules_source": "api+page",
        "leaves_without_web_source": 3
      },
      "duration_ms": 1191,
      "scraped_at": "2026-09-21T11:25:15.624Z"
    },
    "next_cursor": null
  }
}
```

## Response fields

| Field | Type | Example | Description |
|---|---|---|---|
| `subreddits` | string | `AskReddit` |  |
| `subreddit` | object | `{…}` | The results. |
| `next_cursor` | null | `null` | Pass back as `cursor` for the next page. `null` on the last page. |
| `subreddit.input_subreddit` | string | `AskReddit` |  |
| `subreddit.subreddit` | string | `AskReddit` |  |
| `subreddit.status` | string | `ok` |  |
| `subreddit.note` | null | `null` |  |
| `subreddit.http_status` | integer | `200` |  |
| `subreddit.subreddit_id` | string | `t5_2qh1i` |  |
| `subreddit.display_name` | string | `AskReddit` |  |
| `subreddit.weekly_active_users` | integer | `15517795` |  |
| `subreddit.weekly_contributions` | integer | `1139301` |  |
| `subreddit.rules` | string | `1 Rule 1 - Questions must be clear and direct…` |  |
| `subreddit.description` | string | `r/AskReddit is the place to ask and answer th…` |  |
| `subreddit.header_img` | string | `https://styles.redditmedia.com/t5_2qh1i/style…` |  |
| `subreddit.icon_img` | string | `https://styles.redditmedia.com/t5_2qh1i/style…` |  |
| `subreddit.subscribers` | integer | `59684848` |  |
| `subreddit.advertiser_category` | string | `Lifestyles` |  |
| `subreddit.created_at` | string | `2008-01-25T03:52:15.108Z` |  |
| `subreddit.submit_text` | string | `**AskReddit is all about DISCUSSION. Your pos…` |  |
| `subreddit.verified` | boolean | `true` |  |
| `subreddit.following` | null | `null` |  |
| `subreddit.posts_count` | null | `null` |  |
| `subreddit.likes_count` | null | `null` |  |
| `subreddit.url` | string | `https://www.reddit.com/r/AskReddit` |  |
| `subreddit.private` | boolean | `false` |  |
| `subreddit.is_nsfw` | boolean | `false` |  |
| `subreddit.language` | string | `es` |  |
| `subreddit.engagement_rate` | number | `0.0734` |  |
| `subreddit.content_category` | string | `lifestyles` |  |
| `subreddit.estimated_reach` | integer | `15517795` |  |
| `subreddit.title` | string | `Ask Reddit...` |  |
| `subreddit.subreddit_type` | string | `public` |  |
| `subreddit.quarantine` | boolean | `false` |  |
| `subreddit.community_status` | string | `Credit` |  |
| `subreddit.community_status_icon` | string | `https://emoji.redditmedia.com/5atpv9pyenjf1_t…` |  |
| `subreddit.header_title` | string | `Ass Credit` |  |
| `subreddit.description_markdown` | string | `###### [ [ SERIOUS ] ](http://www.reddit.com/…` |  |
| `subreddit.submit_text_label` | string | `Ask a question` |  |
| `subreddit.submission_type` | string | `self` |  |
| `subreddit.primary_color` | string | `#d4eaff` |  |
| `subreddit.key_color` | string | `#222222` |  |
| `subreddit.banner_background_color` | string | `#d4eaff` |  |
| `subreddit.community_icon` | string | `https://styles.redditmedia.com/t5_2qh1i/style…` |  |
| `subreddit.banner_background_image` | string | `https://styles.redditmedia.com/t5_2qh1i/style…` |  |
| `subreddit.mobile_banner_image` | string | `https://styles.redditmedia.com/t5_2qh1i/style…` |  |
| `subreddit.allow_images` | boolean | `false` |  |
| `subreddit.allow_videos` | boolean | `false` |  |
| `subreddit.allow_galleries` | boolean | `false` |  |
| `subreddit.allow_polls` | boolean | `false` |  |
| `subreddit.spoilers_enabled` | boolean | `true` |  |
| `subreddit.wiki_enabled` | boolean | `true` |  |
| `subreddit.restrict_posting` | boolean | `true` |  |
| `subreddit.restrict_commenting` | boolean | `false` |  |
| `subreddit.accept_followers` | boolean | `true` |  |
| `subreddit.whitelist_status` | integer | `6` |  |
| `subreddit.rules_count` | integer | `12` |  |
| `subreddit.rules_list` | array | `[2 items]` |  |
| `subreddit.warnings` | array | `[]` |  |
| `subreddit.stats` | object | `{…}` |  |
| `subreddit.duration_ms` | integer | `1191` |  |
| `subreddit.scraped_at` | string | `2026-09-21T11:25:15.624Z` |  |

## Pagination

Single lookup: everything comes back in one call and `next_cursor` is always `null`.

## Errors

Failed calls are free. Branch on HTTP status; the message is in `error` (or `detail`). See https://docs.scrapier.io/errors.md

- **400** Bad input. The exact message varies by endpoint. `{"success":false,"error":"…"}`
- **402** Balance below the endpoint's price. `{"error":"Insufficient credits. Buy more to scrape more.","balance":1,"required":2}`
- **403** Invalid or unknown API key. `{"detail":"Authentication service unavailable or invalid API key."}`
- **429** Throttled — wait for Retry-After. `{"detail":"Request was throttled. Expected available in N seconds."}`
- **404** unknown slug · **503** busy (retry after `Retry-After`) · **5xx** upstream failure or timeout (retry with backoff).

## Notes

- Nothing special: send the inputs, read the result.

## Related

- [Reddit Comment Replies](https://docs.scrapier.io/api-reference/reddit/reddit-comment-replies.md): Structured Reddit data: send `urls`. Cursor-paginated, 1 credit per successful call.
- [Reddit Post Comments](https://docs.scrapier.io/api-reference/reddit/reddit-comments.md): Structured Reddit data: send `urls`. Cursor-paginated, 1 credit per successful call.
- [Reddit Post Search](https://docs.scrapier.io/api-reference/reddit/reddit-post-search.md): Structured Reddit data: send `queries`. Cursor-paginated, 1 credit per successful call.
- [Reddit Post Transcript](https://docs.scrapier.io/api-reference/reddit/reddit-post-transcript.md): Structured Reddit data: send `urls`. Single lookup, 1 credit per successful call.
