Reddit Subreddit Details API

Endpoint

GET /v1/reddit/subreddit

Parameters

subreddit

Subreddit name, with or without r/, e.g. Python. Provide exactly one of subreddit or url.

url

Subreddit URL, e.g. https://www.reddit.com/r/Python/ (max 500 characters). Provide exactly one of subreddit or url.

Response fields

subreddit

The subreddit

name

Subreddit name

subreddit_id

Subreddit ID

title

Subreddit title

description

Short public description

sidebar

Full sidebar text (Markdown)

url

Link to the subreddit

subscribers

Number of members (null when Reddit hides it)

weekly_active_users

Unique visitors in the past week (null when unavailable)

weekly_contributions

Posts and comments in the past week (null when unavailable)

created_at

Creation date and time (UTC)

type

Community type: public, restricted, private, archived, employees_only, gold_only or user (empty when unavailable)

status

active, or why the community can't be browsed: private, gold_only, banned or quarantined

nsfw

Whether the subreddit is marked NSFW

quarantined

Whether the subreddit is quarantined

icon

Community icon URL, or empty string

banner

Banner image URL, or empty string

language

Language code, e.g. en

Example Request

curl "https://apidirect.io/v1/reddit/subreddit?subreddit=Python" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/reddit/subreddit",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "subreddit": "Python"
    }
)
print(response.json())

Example Response

{
  "subreddit": {
    "name": "Python",
    "subreddit_id": "2qh0y",
    "title": "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. \n-...",
    "sidebar": "####[The Python Discord](https://discord.gg/python)\n\nNews about the dynamic, interpreted, interactive, object-oriented, extensible programming language Pytho...",
    "url": "https://www.reddit.com/r/Python/",
    "subscribers": 1518060,
    "weekly_active_users": 118064,
    "weekly_contributions": 737,
    "created_at": "2008-01-25 03:14:39",
    "type": "public",
    "status": "active",
    "nsfw": false,
    "quarantined": false,
    "icon": "https://styles.redditmedia.com/t5_2qh0y/styles/communityIcon_lctik80p96tg1.png?width=64&frame=1&auto=webp&s=92baaacc951d52b5071629852df033d53cafa5ec",
    "banner": "https://styles.redditmedia.com/t5_2qh0y/styles/bannerBackgroundImage_cd73kiu1502d1.png?frame=1&auto=webp&s=cb043cb4ba040265a97554d8debbeb2ed419db16",
    "language": "en"
  }
}

Frequently asked questions

What does status mean?

active for a normal community. For one that can't be browsed it says why: private, gold_only, banned or quarantined. Those still return whatever Reddit shows publicly (name, ID, creation date, description).

What are weekly_active_users and weekly_contributions?

Reddit's own counts of unique visitors and of posts plus comments over the past week.

How does pricing work?

You only pay for successful requests. The Reddit Subreddit Details API costs $0.003 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.