Skip to content

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

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/reddit-subreddit-info-details/Open in Playground

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

Terminal window
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
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
subredditsstringyese.g. AskRedditSubreddit 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).
cursorstringno—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_pagebooleannotruetrue (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
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen 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.
{
"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
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.subreddit.

FieldTypeExampleDescription
subredditsstringAskReddit—
subredditobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
subreddit.input_subredditstringAskReddit—
subreddit.subredditstringAskReddit—
subreddit.statusstringok—
subreddit.notenullnull—
subreddit.http_statusinteger200—
subreddit.subreddit_idstringt5_2qh1i—
subreddit.display_namestringAskReddit—
subreddit.weekly_active_usersinteger15517795—
subreddit.weekly_contributionsinteger1139301—
subreddit.rulesstring1 Rule 1 - Questions must be clear and direct…—
subreddit.descriptionstringr/AskReddit is the place to ask and answer th…—
subreddit.header_imgstringhttps://styles.redditmedia.com/t5_2qh1i/style…—
subreddit.icon_imgstringhttps://styles.redditmedia.com/t5_2qh1i/style…—
subreddit.subscribersinteger59684848—
subreddit.advertiser_categorystringLifestyles—
subreddit.created_atstring2008-01-25T03:52:15.108Z—
subreddit.submit_textstring**AskReddit is all about DISCUSSION. Your pos…—
subreddit.verifiedbooleantrue—
subreddit.followingnullnull—
subreddit.posts_countnullnull—
subreddit.likes_countnullnull—
subreddit.urlstringhttps://www.reddit.com/r/AskReddit—
subreddit.privatebooleanfalse—
subreddit.is_nsfwbooleanfalse—
subreddit.languagestringes—
subreddit.engagement_ratenumber0.0734—
subreddit.content_categorystringlifestyles—
subreddit.estimated_reachinteger15517795—
subreddit.titlestringAsk Reddit...—
subreddit.subreddit_typestringpublic—
subreddit.quarantinebooleanfalse—
subreddit.community_statusstringCredit—
subreddit.community_status_iconstringhttps://emoji.redditmedia.com/5atpv9pyenjf1_t…—
subreddit.header_titlestringAss Credit—
subreddit.description_markdownstring###### [ [ SERIOUS ] ](http://www.reddit.com/…—
subreddit.submit_text_labelstringAsk a question—
subreddit.submission_typestringself—
subreddit.primary_colorstring#d4eaff—
subreddit.key_colorstring#222222—
subreddit.banner_background_colorstring#d4eaff—
subreddit.community_iconstringhttps://styles.redditmedia.com/t5_2qh1i/style…—
subreddit.banner_background_imagestringhttps://styles.redditmedia.com/t5_2qh1i/style…—
subreddit.mobile_banner_imagestringhttps://styles.redditmedia.com/t5_2qh1i/style…—
subreddit.allow_imagesbooleanfalse—
subreddit.allow_videosbooleanfalse—
subreddit.allow_galleriesbooleanfalse—
subreddit.allow_pollsbooleanfalse—
subreddit.spoilers_enabledbooleantrue—
subreddit.wiki_enabledbooleantrue—
subreddit.restrict_postingbooleantrue—
subreddit.restrict_commentingbooleanfalse—
subreddit.accept_followersbooleantrue—
subreddit.whitelist_statusinteger6—
subreddit.rules_countinteger12—
subreddit.rules_listarray[2 items]—
subreddit.warningsarray[]—
subreddit.statsobject{…}—
subreddit.duration_msinteger1191—
subreddit.scraped_atstring2026-09-21T11:25:15.624Z—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Nothing special: send the inputs, read the result.
  • Reddit Comment Replies — Structured Reddit data: send urls. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Comments — Structured Reddit data: send urls. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Search — Structured Reddit data: send queries. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Transcript — Structured Reddit data: send urls. Single lookup, 1 credit per successful call.