Reddit Subreddit Details
Subreddits form specialized topic-based communities with distinct moderation guidelines, contributor activity, and audience reach. Collecting subreddit metadata delivers community subscriber counts, weekly active user estimates, community rules, and icon imagery.
Features
- Community size and engagementExtract total subscriber counts, weekly active users, and weekly contribution counts for each subreddit.
- Moderation rules extractionRetrieve full markdown community guidelines and submission rules governing user participation.
- Branding and visual assetsCapture community icon images, header artwork, display names, and advertising category classifications.
- Multi-URL batchingSubmit an array of /r/{subreddit} URLs in a single request for aggregated community analysis.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Array of public Reddit /r/{subreddit} community URLs to fetch metadata for. |
How to Use
Submit one or more subreddit URLs as an asynchronous task, then poll for normalized community profiles.
- Prepare one or more public subreddit links, such as https://www.reddit.com/r/technology/.
- Send a POST request to /v1/reddit/subreddit-details with the urls array.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read data.results.items to retrieve the normalized community metadata.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/technology/"]}'
# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.Best Use Cases
- Subreddit audience sizing: Evaluate subscriber counts and weekly active contributors before launching organic outreach or AMAs.
- Rule compliance screening: Parse community rules programmatically to ensure user submissions align with posting policies.
- Topic directory building: Maintain an up-to-date catalog of Reddit communities with categorized descriptions and icons.
Pro Tips
- URLs must point to the community root (e.g. /r/technology/) rather than individual post threads.
- The weekly_active_users and weekly_contributions fields in extra metadata provide reliable health indicators.
- Subreddit names are preserved in original casing in both display_name and name fields.
- Combine with Reddit Subreddit Posts to sample live content from communities that meet your size criteria.
Related APIs
Use these APIs when you need a different type of public Reddit data.
- Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
- Reddit Comments API — Collect public comment text, authors, post and parent-comment references, community context, timestamps, and visible engagement from supported post URLs.
- Reddit Subreddit Posts API — Discover public posts from subreddit URLs with new, top, or hot sorting, a per-subreddit result limit, and normalized community and engagement context.
- Reddit Search API — Search public Reddit posts by text query and publication window, returning normalized content, authors, community context, timestamps, media, and visible engagement.
- Reddit Subreddit Search API