Subreddit API
Get any subreddit's subscribers, description, sidebar, settings, and branding as JSON. $0.01 per call.
Look up any public subreddit and get its title, description, sidebar, subscriber count, creation date, type, language, icon, banner, advertiser category, and content settings such as whether images, videos, and polls are allowed and whether the wiki is enabled.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"active_users": null,
"advertiser_category": "Technology",
"allow_images": false,
"allow_polls": false,
"allow_videos": false,
"banner": "https://styles.redditmedia.com/t5_2qh0y/styles/bannerBackgroundImage_cd73kiu1502d1.png?width=4000&s=adab92e03af7e628f0df484bb7aab107176435b7",
"created_at": "2008-01-25T03:14:39+00:00",
"created_utc": 1201230879,
"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---\n\nIf you have questions or are new to Pyt…",
"icon": "https://styles.redditmedia.com/t5_2qh0y/styles/communityIcon_lctik80p96tg1.png?width=256&s=6d91fcc92d9f08c5ba30096d43a555ddd0edbc7d",
"id": "2qh0y",
"lang": "en",
"name": "Python",
"over_18": false,
"quarantine": false,
"sidebar": "####[The Python Discord](https://discord.gg/python)\n\nNews about the dynamic, interpreted, interactive, object-oriented, extensible programming language Python\n\n# Upcoming Events\n[Full Events Calendar]…",
"submission_type": "self",
"subscribers": 1520338,
"title": "Python",
"type": "public",
"url": "https://www.reddit.com/r/Python/",
"wiki_enabled": true
}
}Features
Returns name, title, description, sidebar, subscribers, active_users, created_at, type, lang, url, icon, and banner in one call.
See submission_type, allow_images, allow_videos, allow_polls, wiki_enabled, quarantine, and over_18 before you post or scrape.
The subreddit field accepts python, r/python, or a full reddit.com/r/python URL.
Missing, banned, and private communities return a 404 NOT_FOUND, and you are not charged for it.
Community profiles change slowly, so lookups are cached for an hour and come back fast.
Use cases
Community Analytics
Track subscriber growth for a list of subreddits over time.
Posting Tools
Check whether a community accepts links, images, or videos before a user submits.
Directory Pages
Render rich subreddit cards with icon, banner, and description.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/subreddit', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"subreddit": "python"
}),
});
const data = await res.json();
console.log(data);The Subreddit API for community profiles and settings
The YepAPI Subreddit API returns everything public about a Reddit community in one call. Send a subreddit name to /v1/reddit/subreddit and get its title, description, sidebar, subscriber count, creation date, language, icon, banner, advertiser category, and content settings, at $0.01 per call.
It is the lookup you run before anything else: confirm the community exists, check how big it is, and see what kind of posts it allows.
What is a subreddit API?
A subreddit API returns the metadata of a Reddit community as structured data. Instead of parsing the About sidebar of a subreddit page, you get a JSON object with subscribers, created_at, type, lang, url, icon, banner, sidebar text, and settings such as submission_type, allow_images, allow_videos, allow_polls, wiki_enabled, and quarantine.
Build subreddit tracking and directories
Call /v1/reddit/subreddit daily for the communities you care about and chart subscribers over time. Or use the icon, banner, and description to render community cards in a directory or a research tool. Pair it with the Subreddit Posts API for the feed and the Subreddit Rules API for posting guidelines.
Subreddit API pricing: $0.01 per call
Every call costs a flat $0.01 and failed calls are free. There is no monthly minimum, no seat fee, and no Reddit app to register: you only need a YepAPI key. Community lookups are cached for an hour, and a 404 for a missing or private subreddit costs nothing.
Errors you can rely on
If a subreddit does not exist, is banned, or is private, the endpoint returns 404 NOT_FOUND instead of an empty object, so your app can tell "no such community" apart from "no data".
Try the Subreddit API free
Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Subreddit API against live Reddit data before you spend anything. Add the posts, comments, rules, and similar-subreddits endpoints on the same key.
Start making API calls in 30 seconds
$5 free credit on signup. No credit card required. Pay per call.
What developers say
“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Frequently asked questions
Look up any public subreddit and get its title, description, sidebar, subscriber count, creation date, type, language, icon, banner, advertiser category, and content settings such as whether images, videos, and polls are allowed and whether the wiki is enabled.
Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.
Sign up for a free API key, then send a POST request to /v1/reddit/subreddit. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.
YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.
Ready to integrate?
Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.
More Reddit API endpoints
Subreddit Posts API
$0.01Pull hot, new, top, or controversial posts from any subreddit as JSON. A subreddit scraper at $0.01 per call.
Subreddit Comments API
$0.01Stream the latest comments posted anywhere in a subreddit, with post context. $0.01 per call.
Subreddit Rules API
$0.01Get a subreddit's posting rules with descriptions and removal reasons. $0.01 per call.
Similar Subreddits API
$0.01Find subreddits related to any community, with subscriber counts and descriptions. $0.01 per call.
Reddit Post API
$0.01Get any Reddit post by URL: title, body, score, comment count, flair, and media. $0.01 per call.
Reddit Comments API
$0.01Get the full comment tree of any Reddit post with nested replies. A Reddit comment scraper at $0.01 per call.