Similar Subreddits API
Find subreddits related to any community, with subscriber counts and descriptions. $0.01 per call.
Give a subreddit and get related communities Reddit associates with it. Each result includes name, title, description, subscriber count, creation date, type, language, icon, and banner, with cursor pagination.
Try it live
Fill in the fields and hit Run to see a real response.
{
"ok": true,
"data": {
"cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2Vj…",
"subreddits": [
{
"active_users": null,
"banner": null,
"created_at": null,
"created_utc": null,
"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=64&frame=1&auto=webp&s=92baaacc951d52b5071629852df033d53cafa5ec",
"id": null,
"lang": null,
"name": "Python",
"over_18": false,
"subscribers": null,
"title": null,
"type": null,
"url": "https://www.reddit.com/r/Python/"
}
]
}
}Features
Start with a subreddit you know and get the communities Reddit considers similar.
Each result has subscribers, description, created_at, over_18, type, lang, url, icon, and banner.
Page through longer lists of related communities.
Related-community lists change slowly and are cached for an hour.
Use cases
Audience Expansion
Grow a list of target communities from the one you already know works.
Competitive Mapping
Map the community landscape around a product category.
Recommendations
Suggest related communities to users of your app.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/similar-subreddits', {
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 Similar Subreddits API for mapping related communities
The YepAPI Similar Subreddits API finds communities related to one you already know. Send a subreddit to /v1/reddit/similar-subreddits and get back related subreddits with subscriber counts, descriptions, icons, and banners, at $0.01 per call.
Keyword search finds communities that use a word. This endpoint finds communities with the same audience, which is usually what you actually want.
What does the Similar Subreddits API return?
A subreddits array of full Subreddit objects (id, name, title, description, subscribers, active_users, created_at, over_18, type, lang, url, icon, banner) plus a cursor.
Build an audience map
Start from one subreddit that converts well, call /v1/reddit/similar-subreddits, then call it again for each result to grow a graph of related communities. Rank the graph by subscribers, check each one's rules with the Subreddit Rules API, and you have a target list for research or outreach.
Similar Subreddits 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. Results are cached for an hour.
Pair it with Subreddit Search
Use the Subreddit Search API when you have a keyword and the Similar Subreddits API when you have a seed community. Together they cover nearly every community around a niche.
Try the Similar Subreddits 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 Similar Subreddits API against live Reddit data before you spend anything. Every Reddit and Twitter / X endpoint is 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
Give a subreddit and get related communities Reddit associates with it. Each result includes name, title, description, subscriber count, creation date, type, language, icon, and banner, with cursor pagination.
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/similar-subreddits. 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 API
$0.01Get any subreddit's subscribers, description, sidebar, settings, and branding as JSON. $0.01 per call.
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.
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.