POST/api/v1/search-communitiesSearch

Search Communities

Search for subreddits (communities) by name or topic keyword. Returns a list of matching subreddits with their subscriber counts and descriptions.

Ready to try it?

Create a free account — 30 requests included, no credit card.

Get free API key →

Request Parameters

Send as a JSON body in your POST request.

Parameter	Type	Required	Description
query	string	Yes	The keyword to search for (e.g., 'programming').
limit	number	No	Number of communities to return (max 100). Default: 25.
after	string	No	Pagination cursor.

Code Examples

curl

curl -X POST https://subscraper.dev/api/v1/search-communities \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "artificial intelligence",
    "limit": 5
  }'

TypeScript SDK

const communities = await client.searchCommunities({
  query: "artificial intelligence",
  limit: 5
});

Install the SDK →

Sample Response

{
  "communities": [
    {
      "name": "ArtificialInteligence",
      "title": "Artificial Intelligence",
      "subscribers": 450000,
      "publicDescription": "The latest news in AI, machine learning, and robotics.",
      "nsfw": false
    },
    {
      "name": "MachineLearning",
      "title": "Machine Learning",
      "subscribers": 3000000,
      "publicDescription": "Machine Learning news, research, and discussion.",
      "nsfw": false
    }
  ],
  "after": "t5_2qw2d"
}