Reddit Subreddit Details API
Scrape Reddit Subreddit Details data with one API call. Returns detailed information about a subreddit including subscriber count, active user count, description, creation date, rules, and subreddit icon URL. Note: the subreddit name is case-sensitive here: pass the subreddit's canonical casing (e.g. `AskReddit`, not `askreddit`). An incorrect casing returns a refunded 404.
Last updated August 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 51 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"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/reddit/subreddit/details",
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/reddit/subreddit/details",
{
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": "programming",
"username": "programming",
"display_name": "programming",
"avatar_url": "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=128&frame=1&auto=webp&s=400b33e7080aa4996c405a96b3872a12f0e3b68d",
"bio": "Computer Programming",
"verified": null,
"followers": null,
"following": null,
"posts_count": null,
"likes_count": null,
"url": null,
"private": null,
"joined_at": "2006-02-28T18:19:29.538Z",
"ext": {
"weekly_active_users": 226847,
"weekly_contributions": 2450
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": "other",
"estimated_reach": null
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false
}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 51 platforms covering 10B+ monthly active users.
One schema, every platform
Query 51 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.
