Reddit Subreddit Details API
Scrape Reddit Subreddit Details data with one API call. Returns detailed information about a subreddit including the subscriber count at `author.followers`, weekly active users and weekly contributions at `author.ext.weekly_active_users` and `author.ext.weekly_contributions`, the description, creation date, rules, and subreddit icon URL. The subscriber count and Reddit's own community language tag at `author.ext.language` come from a second source that runs only when the main one leaves the count empty, so on a small share of calls they are null while every other field is unchanged. The subreddit name is case-sensitive on the main source: pass the canonical casing (e.g. `AskReddit`, not `askreddit`) to get the whole object. A non-canonical spelling is not a 404 — it falls through to the second source, which still answers with the core fields but without the weekly-activity numbers.
Last updated October 2026Maintained by the SocialCrawl team
Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL.
Use it to size up a community before pulling its posts; the name is case-sensitive here, so spell it exactly as Reddit does.
Searching 68 platforms in parallel
What can you do with the Subreddit Details API?
The Subreddit Details endpoint gives you structured Reddit data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/reddit/subreddit/details?subreddit=AskReddit"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/reddit/subreddit/details",
params={
'subreddit': 'AskReddit',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/reddit/subreddit/details?subreddit=AskReddit",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| subreddit | No | Subreddit name without the r/ prefix. Case-sensitive: use the subreddit's canonical casing (e.g. `AskReddit`). |
| url | No | Subreddit URL |
What does the Reddit Subreddit Details API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/subreddit/details",
"data": {
"author": {
"id": "AskReddit",
"username": "AskReddit",
"display_name": "AskReddit",
"avatar_url": "https://styles.redditmedia.com/t5_2qh1i/styles/communityIcon_p6kb2m6b185b1.png?width=128&frame=1&auto=webp&s=1124511c3a95cc4ec094a4e8886de1e08a0f1e0a",
"bio": "r/AskReddit is the place to ask and answer thought-provoking questions.",
"verified": null,
"followers": 59785424,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://www.reddit.com/r/AskReddit",
"private": null,
"joined_at": "2008-01-25T03:52:15.108Z",
"ext": {
"is_nsfw": false,
"weekly_active_users": 13295443,
"weekly_contributions": 1097994,
"rules_text": "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 mark All context in the title must be necessary to understanding the question; do not give “example answers” in the post title (i.e. “Other than your mom, ______?”) No text in the text box - any additional info from you must be added as a comment to your post The full rule can be viewed here\n\n2 Rule 2 - No personal or professional advice requests Askreddit is NOT your personal or professional advice platform Do not makes posts asking for professional advice - medical, legal, financial, or otherwise All posts asking for advice must be generic and not specific to your situation alone Do not use first person pronouns No crowdsourcing naming or purchasing decisions The full rule can be viewed here\n\n3 Rule 3 - Open ended questions only Post must be an open-ended discussion question Title must not be phrased to allow a simple yes/no answer No questions that have definite answers Question must not be a poll or survey No “Either/Or” type questions Do not ask for NSFW links Do not specify a length (eg \"in three words...\") or make your post into a game The full rule can be viewed here\n\n4 Rule 4 - No personal info Do not post or seek any real or fake personal information (examples include: full names, phone numbers, email addresses, or social media accounts) Only link another user's comment when it is relevant and never when it is to launch a personal attack or encourage others to do so Do not ask questions designed to target specific usernames or links to social media The full rule can be viewed here\n\n5 Rule 5 - No loaded questions Do not include an opinion, bias, or lead respondents towards expressing a specific opinion in your post title Do not use this subreddit to promote a specific agenda or to gain positive or negative publicity for an entity or person The full rule can be viewed here\n\n6 Rule 6 - [Serious] tagged posts are off-limits to jokes or irrelevant replies [Serious] posts are off-limits for joke replies and irrelevant or off-topic comments and discussion If the OP asks for answers from a specific group in a [Serious] post, top level comments must be made from members of that group Posts that do not receive relevant answers within an hour will be removed The full rule can be viewed here\n\n7 Rule 7 - No begging for goods or services, or Reddit rewards Do not ask for Reddit rewards, money, goods, services,or favors Do not form a brigade to draw positive or negative attention to posts or comments in AskReddit, even from other subreddits The full rule can be viewed here\n\n8 Rule 8 - Be respectful to other users at all times and conduct your behaviour in a civil manner Do not make personal attacks, insult, or demean a specific group or person Do not use slurs without relevant context and quotes No blatant statements of bigotry No posts that 'bait' users into breaking other rules Zero tolerance for posts/comments that sexualize minors Zero tolerance for posts/comments that encourage suicide The full rule can be viewed here\n\n9 Rule 9 - No image only replies or large ascii art Comment replies must consist of more than just an image or link No ASCII/emoji images over one line The full rule can be viewed here\n\n10 Rule 10 - Harmful Misinformation Do not downplay the effects of a medical crisis Do not undermine the efficacy of vaccines where there is widespread agreement among the medical and scientific communities Do not encourage illegal activity Do not encourage delayed medical treatment The full rule can be viewed here\n\n11 Rule 11 - No spam, machine generated content or karma farming Do not post spam Do not edit comments to mislead and/or advertise Do not farm karma or shotgun comments Bots are not allowed in r/AskReddit The full rule can be viewed here\n\n12 Rule 12 - All content must be written in English All content must be written in English so that it is widely understood by the user base of the sub. Posts not in English will be removed. Comments not in English may be removed. The full rule can be viewed here",
"language": "en"
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
}
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T15:39:31.337Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Reddit Subreddit Details API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get subreddit details with an API?
What fields does the subreddit details endpoint return?
Can I pass a subreddit URL instead of the name?
How fresh is the subscriber count?
How much does the Subreddit Details API cost?
Ask AI about SocialCrawl
Ready to scrape Reddit Subreddit Details data?
Get your API key and start pulling Reddit data in under 60 seconds.
