M
MesmerTools
GET/v1/reddit/subreddit/details

Subreddit details API

Returns the about-page metadata for a subreddit: display name, subscriber count, weekly active users, the full sidebar Markdown (rules), the short public_description, advertiser category, and the styled banner/icon URLs.

Authentication

Include x-api-key: <your_key> in your request headers
Requests without a valid key get a 401 Unauthorized. Revoked keys return 403 Forbidden.
Get a key

Parameters

subredditEither/Or
string
Subreddit name (e.g. "Python"). One of subreddit or url is required.
urlEither/Or
string
Any Reddit URL we can extract the sub name from.
You must supply one of subreddit or url.

Example request

curl "https://mesmer.tools/api/v1/reddit/subreddit/details?subreddit=Python" \
  -H "x-api-key: <YOUR_API_KEY>"

Try it now

Hits the live endpoint with your API key.

Saved locally in your browser. Mint a key in /admin/api-keys.

Response schema

Trimmed example — see Field reference for descriptions.

{
  "success": true,
  "credits_remaining": -1,
  "subreddit_id": "t5_2qh0y",
  "display_name": "Python",
  "description": "News about the Python programming language and its community.",
  "rules": "## Welcome to r/Python!\n\n**r/Python** is a subreddit for discussions about the Python programming language...",
  "subscribers": 1322000,
  "weekly_active_users": 18450,
  "weekly_contributions": 4120,
  "advertiser_category": "Technology",
  "icon_img": "https://b.thumbs.redditmedia.com/...png",
  "header_img": "https://styles.redditmedia.com/...jpg",
  "created_at": 1232649350,
  "submit_text": ""
}

Field reference

Top-level response fields you'll most likely use.

subreddit_id
string
Reddit's t5_* id for the subreddit.
display_name
string
Canonical case-preserved name (e.g. "Python").
description
string
Short, plain-text public_description from the about page.
rules
string
Long Markdown sidebar — what Reddit confusingly calls `description`.
subscribers
number
Total subscribers.
weekly_active_users
number
Estimated active users in the last 7 days.
weekly_contributions
number
Posts + comments in the last 7 days.
advertiser_category
string
Reddit's coarse category label.
icon_img
string
URL to the subreddit's icon image.
header_img
string
URL to the subreddit's header/banner image.
Previous
Subreddit search
/v1/reddit/subreddit/search
Next
Reddit search
/v1/reddit/search