# Reddit Subreddit Search API. Subreddits matching your search. Subreddits by keyword, with weekly visitors. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.search_subreddits) ## Reddit Subreddit Search API at a glance Searches public subreddits by keyword and returns them a page at a time, in Reddit's relevance order. Each has its name, ID, link, description and icon, whether it is marked NSFW or quarantined, and the exact weekly visitors and contributions Reddit shows beside it. Queries in any language work. GET `/v1/reddit/search_subreddits` [Read the API reference](https://socialtap.dev/docs/reference/reddit/search_subreddits/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **17 typed fields** null when unknown - **10** subreddits per page, Reddit's relevance order - **`query`** is all it needs, e.g. `golang` ## Send one request. Get up to 10 subreddits back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `query = golang` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.search_subreddits) cURL: ```shell curl 'https://socialtap.dev/v1/reddit/search_subreddits?query=golang' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.reddit.searchSubreddits.list({ query: "golang" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "golang", }); const res = await fetch(`https://socialtap.dev/v1/reddit/search_subreddits?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/reddit/search_subreddits", params={"query": "golang"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("query", "golang") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/search_subreddits?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "avatar_url": "https://styles.redditmedia.com/t5_2rc7j/styles/communityIcon_wy4riduoe9k11.png?width=64&frame=1&auto=webp&s=b35b0d214c4c3462cd4d4e0966f04f005cbe2576", "banner_url": null, "categories": [], "created_at": null, "description": "Ask questions and post articles about the Go programming language and related tools, events etc.", "id": "t5_2rc7j", "is_nsfw": false, "metrics": { "member_count": null }, "moderators": [], "name": "golang", "platform": "reddit", "platform_specific": { "reddit": { "is_quarantined": false, "member_nickname": null, "weekly_contribution_count": 680, "weekly_visitor_count": 74052 } }, "privacy": null, "rules": [], "title": null, "unknown_fields": [ "categories", "moderators", "rules" ], "url": "https://www.reddit.com/r/golang/" }, { "approximate_fields": [], "avatar_url": "https://styles.redditmedia.com/t5_3hpdu/styles/communityIcon_g9aiugyvoo7b1.jpg?width=64&frame=1&auto=webp&s=5419ac02a033662bff6352aa4e1c91d0034e4188", "banner_url": null, "categories": [], "created_at": null, "description": "/r/golang2: an unofficial plan B subreddit in case they decide to screw the official one", "id": "t5_3hpdu", "is_nsfw": false, "metrics": { "member_count": null }, "moderators": [], "name": "golang2", "platform": "reddit", "platform_specific": { "reddit": { "is_quarantined": false, "member_nickname": null, "weekly_contribution_count": 0, "weekly_visitor_count": 5 } }, "privacy": null, "rules": [], "title": null, "unknown_fields": [ "categories", "moderators", "rules" ], "url": "https://www.reddit.com/r/golang2/" }, { "approximate_fields": [], "avatar_url": "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=64&frame=1&auto=webp&s=2545f3c0332e412c8635f5f2a5868c0e857ef040", "banner_url": null, "categories": [], "created_at": null, "description": "Computer Programming", "id": "t5_2fwo", "is_nsfw": false, "metrics": { "member_count": null }, "moderators": [], "name": "programming", "platform": "reddit", "platform_specific": { "reddit": { "is_quarantined": false, "member_nickname": null, "weekly_contribution_count": 1735, "weekly_visitor_count": 217174 } }, "privacy": null, "rules": [], "title": null, "unknown_fields": [ "categories", "moderators", "rules" ], "url": "https://www.reddit.com/r/programming/" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 660, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/reddit/search_subreddits/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/community/index.md). - ### Null means unknown A field Reddit doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts Words to find subreddits by, matched by Reddit's community search against their names and descriptions (golang, home brewing, fußball). - ### Write one parser Reddit, Facebook and X answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (reddit, facebook, …). - **`id`string**: Platform-native community ID (string): Reddit's subreddit ID with its t5_ prefix, Facebook's numeric group ID. - **`name`string**: The name its links use, without a prefix (golang for r/golang; a Facebook group's vanity name); null when it has none (a Facebook group known only by its number). - **`title`string**: The community's title as its page shows it ("The Go Programming Language"; what Facebook calls a group's name); null when it has none. - **`description`string**: Its short description as plain text; null when it has none. - **`url`string**: Canonical community URL (https://www.reddit.com/r/golang/, https://www.facebook.com/groups/\/). - **`avatar_url`string**: The community's icon or picture; null when it has none. Platform CDN URLs can expire. - **`banner_url`string**: Header or cover image URL; null when it has none. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Reddit Subreddit Search API. - ### Find where a topic or brand is discussed - ### Build a list of communities to monitor - ### Compare subreddits on one subject by activity - ### Resolve a topic to subreddit names ## Good to know before you build. - Reddit ranks relevance per visitor. A walk keeps one logged-out session, so its pages follow one ranking, but two walks of the same query can differ. - Reddit's search leaves NSFW and quarantined subreddits out logged out, so they aren't found here. The Reddit Subreddit API reads one by name. - Results show only what Reddit's search shows: title, creation date, privacy, banner, member nickname and rules are null (rules listed in unknown_fields). The Reddit Subreddit API returns them. - Reddit shows no subscriber count logged out, so metrics.member_count is null. platform_specific.reddit.weekly_visitor_count and weekly_contribution_count are the activity Reddit shows instead. - Reddit's community search matches loosely: a query no subreddit name or description contains still returns Reddit's nearest matches. - Reddit serves a limited number of result pages per search. A walk that reaches the last one ends with end_reason platform_limit. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/reddit/search_subreddits/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Reddit Subreddit Search API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/search_subreddits/index.md). **How much does the Reddit Subreddit Search API cost?** A page of up to 10 subreddits costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour. Other platforms ## Communities on 2 more platforms. - [Facebook Group API](https://socialtap.dev/apis/facebook/group/index.md) (1 credit · `GET /v1/facebook/group`) - [X (Twitter) Community API](https://socialtap.dev/apis/x/community/index.md) (1 credit · `GET /v1/x/community`) More Reddit ## Reddit API. 13 endpoints, one key. - [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`) - [Reddit Search API](https://socialtap.dev/apis/reddit/search_posts/index.md) (1 credit / page · `GET /v1/reddit/search_posts`) - [Reddit User Posts API](https://socialtap.dev/apis/reddit/posts/index.md) (1 credit / page · `GET /v1/reddit/posts`) - [Reddit Subreddit Posts API](https://socialtap.dev/apis/reddit/subreddit_posts/index.md) (1 credit / page · `GET /v1/reddit/subreddit_posts`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Reddit User Search API](https://socialtap.dev/apis/reddit/search_profiles/index.md) (1 credit / page · `GET /v1/reddit/search_profiles`) - [Reddit Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/comments`) - [Reddit User Comments API](https://socialtap.dev/apis/reddit/profile_comments/index.md) (1 credit / page · `GET /v1/reddit/profile_comments`) - [Reddit Comment Search API](https://socialtap.dev/apis/reddit/search_comments/index.md) (1 credit / page · `GET /v1/reddit/search_comments`) - [Reddit Video Transcript API](https://socialtap.dev/apis/reddit/transcript/index.md) (From 1 credit · `GET /v1/reddit/transcript`) - [Reddit Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`) - [Reddit Subreddit API](https://socialtap.dev/apis/reddit/subreddit/index.md) (1 credit · `GET /v1/reddit/subreddit`) ## Try it with your own search. Type it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/reddit/search_subreddits/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)