Subreddit Search API

Search Reddit for communities matching a phrase. Each result includes the subreddit name, description, weekly visitors and contributions, icon and link.

Endpoint: POST /reddit/search/communities
Price: 1 credit per request
SDK: client.reddit.searchCommunities()
MCP tool: reddit_search_communities

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/search/communities" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "mechanical keyboards"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/search/communities",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "query": "mechanical keyboards",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/search/communities", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "mechanical keyboards"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.searchCommunities({
  query: "mechanical keyboards"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Subreddit Search API return?

Subreddit search API: find subreddits about any topic by keyword, with each community’s name, description, weekly visitors and contributions, icon and link. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

querystringrequired: The text to search Reddit for, e.g. "openai", "best keyboard".
subredditstring: Restrict the search to a single subreddit (name with or without the "r/" prefix). Only applies to post search.
sortenum: Result ordering. Defaults to "relevance".; relevance | hot | top | new | comments
timeenum: Restrict results to a recent window. Defaults to "all".; hour | day | week | month | year | all
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "communities": [
      {
        "id": "string",
        "fullname": "string",
        "name": "string",
        "namePrefixed": "string",
        "description": "string",
        "weeklyVisitors": 0,
        "weeklyContributions": 0,
        "over18": true,
        "quarantined": true,
        "url": "string",
        "communityUrl": "string",
        "iconUrl": "string"
      }
    ],
    "query": "string"
  }
}

[ USE CASES ]

What can you build with the Subreddit Search API?

Find your audience

List the subreddits that talk about your topic and how active each one is.

Plan a launch

Choose which communities to share in before you post.

Map a niche

See how many communities exist around a subject and how big they are.

[ FAQ ]

Subreddit Search API questions

How do I find subreddits about a topic?

Send the topic as the query, for example mechanical keyboards. Each subreddit comes back with its name, description, weekly visitors and contributions, icon and link.

How do I choose which subreddits to market in?

Search your category and compare weekly visitors, then read each candidate’s rules with the Subreddit API and its top posts with the Subreddit Posts API before you post.

How do I get more than 10 subreddits from a search?

Each call returns up to 10 subreddits and a nextCursor. Send the same query with it as cursor to get the next page; it is null when there are no more results.

How do I use the Subreddit Search API?

Send a POST request to https://api.bridgly.app/reddit/search/communities with query in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.searchCommunities(). AI agents connected to Bridgly over MCP can call the reddit_search_communities tool.

How much does the Subreddit Search API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Subreddit Search API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs