Subreddit Finder
GET
/v1/reddit/subreddits/searchMCP
reddit_communities2 creditsLiveUpdated
Description
Find subreddits about a topic. Returns each community's name, title, description, subscriber count, creation date and NSFW flag (rules and moderators are not included; call reddit.subreddit for those). Costs 2 credits per page. Tip: search the problem your customer has, not your product name.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
q | query | string | yes | Topic to find communities for. | |
nsfw | query | boolean,string | no | Include adult communities. true is billed as reddit.nsfw_communities and needs the 18+ setting. | |
limit | query | integer | no | 25 | Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. |
cursor | query | string | no | Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048. |
- q query, string, required
- Topic to find communities for.
- nsfw query, boolean,string
- Include adult communities. true is billed as reddit.nsfw_communities and needs the 18+ setting.
- limit query, integer
- Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. Default
25. - cursor query, string
- Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
Request examples
curl "https://chatterapi.com/v1/reddit/subreddits/search?q=saas+marketing" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is a list of Subreddit, with page.nextCursor and page.hasMore for the next page. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
name | string | no | Name. |
title | string | yes | Title. |
description | string | yes | Description. |
subscribers | number | yes | Subscriber count. |
createdAt | string | yes | ISO 8601 UTC timestamp. |
nsfw | boolean | yes | Marked adult content. |
url | string | no | Subreddit URL. |
rules | object[] | yes | Subreddit rules, or null when the source cannot see them. |
moderators | object[] | yes | Moderators and since when, or null. |
posting | object | yes | Posting settings, or null. |
response
{
"data": [
{
"name": "SaaSMarketing",
"title": "SaaSMarketing",
"description": "A community dedicated to sharing and discussing all aspects of SaaS marketing, from super tactical stuff all the way up to overarching strategy. \n\nIf you're a SaaS founder and you're making $5K-$500K MRR, consider joining our premium mastermind community StartupSauce.com as well.",
"subscribers": 37320,
"createdAt": "2021-08-14T09:41:52.000Z",
"nsfw": false,
"url": "https://www.reddit.com/r/SaaSMarketing/",
"rules": null,
"moderators": null,
"posting": null
},
{
"name": "B2BSaaS",
"title": "B2B SaaS: It's big enough to deserve its own subreddit.",
"description": "This subreddit is directed at anyone involved in a B2B SaaS business.\n\nTypical topics include conversions, retention, churn, metrics, analytics, engagement, inbound marketing, distribution channels and so on.\n\nShare advice, growth hacks, links, questions or personal stories that people who are working on B2B SaaS products can relate to.\n\n",
"subscribers": 30565,
"createdAt": "2014-02-01T19:34:22.000Z",
"nsfw": false,
"url": "https://www.reddit.com/r/B2BSaaS/",
"rules": null,
"moderators": null,
"posting": null
},
{
"name": "SaaS_Email_Marketing",
"title": "SaaS Email Marketing Tips and Hacks ",
"description": "Email Marketing for SaaS is different. \n\nFrom personalized subject lines to email copy that just blows you away, there's a lot that goes into email marketing. This subreddit talks about some of the amazing SaaS email campaigns you come across, the tips and tricks that work, what doesn't, and what cold email tools we use and why. \n\nLet's learn, share, and discuss:\n- email marketing\n- cold email marketing campaign tips\n- newsletters\n- and deliverability",
"subscribers": 14215,
"createdAt": "2016-12-23T23:06:54.000Z",
"nsfw": false,
"url": "https://www.reddit.com/r/SaaS_Email_Marketing/",
"rules": null,
"moderators": null,
"posting": null
}
],
"page": {
"nextCursor": "eyJ2IjoxLCJwIjoiY2l0ZXJvY2tldCIsImMiOiJ0NV9ja2s1MjgiLCJvIjowLCJoIjoiZWIwYTI1OTVkNzEyIn0",
"hasMore": true
},
"credits": {
"charged": 2,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-07, truncated to 3 items. Credits and request id are illustrative.
Credits
2 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 24 hours are served from cache.