M
MesmerTools
GET/v1/reddit/subreddit/details

Subreddit details API

Returns a subreddit's community metadata: id, display name, weekly active users and weekly contributions (the figures Reddit shows on the community page), the numbered community rules as plain text, the short description, the banner/icon URLs and the creation date. Reddit's web pages no longer expose subscriber counts, advertiser category or submit text, so those fields are omitted. Unknown or private subreddits return 404.

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": "The largest Python community for Reddit! Stay up to date with the latest news, packages, and meta information relating to the Python programming language. ...",
  "rules": "1. No showcase posts\nDue to an increase of showcases featuring AI content ...\n\n2. ...",
  "weekly_active_users": 109435,
  "weekly_contributions": 851,
  "icon_img": "https://styles.redditmedia.com/t5_2qh0y/styles/communityIcon_...png",
  "header_img": "https://styles.redditmedia.com/t5_2qh0y/styles/bannerBackgroundImage_...png",
  "created_at": "2008-01-25T03:14:39.000Z"
}

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.
rules
string
Numbered community rules as plain text ("1. Title\nDetails…").
weekly_active_users
number
Weekly visitors, as shown on the community page.
weekly_contributions
number
Posts + comments in the last 7 days.
icon_img
string
URL to the subreddit's icon image.
header_img
string
URL to the subreddit's banner image.
created_at
string
Creation time, ISO-8601.
Previous
Subreddit search
/v1/reddit/subreddit/search
Next
Reddit search
/v1/reddit/search