Subreddit Search API
Find subreddits by keyword with subscriber counts, descriptions, and icons. $0.01 per call.
Search Reddit communities by keyword. Each subreddit comes back with name, title, description, subscriber count, creation date, NSFW flag, type, language, URL, icon, and banner, with cursor pagination for deeper results.
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
Send any topic and get the subreddits Reddit associates with it, ranked the way Reddit's own community search ranks them.
Every result includes subscribers, created_at, over_18, type (public, restricted, and so on), lang, url, icon, and banner.
Page through long result lists with the cursor field returned on every response.
Results use the same Subreddit object as the Similar Subreddits and Popular Subreddits APIs, so one parser covers all three.
Use cases
Community Discovery
Find where your audience hangs out before you post, advertise, or research.
Niche Research
Size a topic by the number and subscriber counts of the communities around it.
Lead Sources
Build lists of relevant communities for listening and outreach tools.
Quick start
Copy this snippet and start making calls.
const res = await fetch('https://api.yepapi.com/v1/reddit/search-subreddits', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"query": "python"
}),
});
const data = await res.json();
console.log(data);The Subreddit Search API for finding Reddit communities
The YepAPI Subreddit Search API finds Reddit communities by keyword. Send a topic to /v1/reddit/search-subreddits and get back matching subreddits with name, title, description, subscriber count, creation date, NSFW flag, language, icon, and banner, at $0.01 per call.
It is the starting point for any Reddit research workflow: find the communities first, then pull their posts, comments, and rules with the other Reddit endpoints.
What does the Subreddit Search API return?
A list of Subreddit objects plus a cursor. Each object carries id, name, title, description, subscribers, active_users, created_utc, created_at, over_18, type, lang, url, icon, and banner. That is enough to rank communities by size, filter out NSFW ones, and render a clean community picker without a second request.
Build a community finder
Let users type a topic, call /v1/reddit/search-subreddits, sort the results by subscribers, and show each community's icon and description. When they pick one, call the Subreddit Posts API for its feed and the Subreddit Rules API to check what is allowed before posting.
Subreddit Search 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. Each page of results is one call, and results are cached for 15 minutes.
Combine with Similar Subreddits
Search gives you communities that match a keyword. The Similar Subreddits API gives you communities related to one you already know. Using both is the quickest way to map every community around a niche.
Try the Subreddit Search 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 Search API against live Reddit data before you spend anything. The same key works for every Reddit and Twitter / X endpoint.
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
Search Reddit communities by keyword. Each subreddit comes back with name, title, description, subscriber count, creation date, NSFW flag, type, language, URL, icon, and banner, with cursor pagination for deeper results.
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/search-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
Reddit User Search API
$0.01Search Reddit accounts by name and get usernames, karma, and avatars. $0.01 per call.
Reddit Search API
$0.01Search all of Reddit or a single subreddit by keyword and get matching posts as clean JSON. $0.01 per call.
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.