POST/api/v1/exploreDiscover

Explore Topics

Fetch a curated list of subreddits grouped by high-level topics (e.g., Technology, Sports, Entertainment) to help users discover new communities.

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
topic	string	No	Specific topic to filter by (e.g., 'technology', 'art'). If omitted, returns a directory of topics.
limit	number	No	Number of results to return. Default: 25.

Code Examples

curl

curl -X POST https://subscraper.dev/api/v1/explore \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "technology",
    "limit": 5
  }'

TypeScript SDK

const topics = await client.explore({
  topic: "technology",
  limit: 5
});

Install the SDK →

Sample Response

{
  "topic": "technology",
  "communities": [
    {
      "name": "technology",
      "subscribers": 14000000,
      "publicDescription": "Subreddit dedicated to the news and discussions about the creation and use of technology."
    },
    {
      "name": "gadgets",
      "subscribers": 21000000,
      "publicDescription": "From smartphones to smart homes, all things gadgets."
    }
  ]
}

Common Use Cases

Building an onboarding flow for a Reddit client
Categorizing communities automatically
Broad market research across an entire industry segment

Credits

Each call to /api/v1/explore uses 1 credit. Free tier includes 30 credits. View pricing →

Related Tools & Guides

All developer tools →

Sandbox→

API Playground

Explore curated communities grouped by vertical.

Use Case→

Reddit API for Startups

Explore industry verticals to validate startup ideas.

Related Endpoints

leaderboard— Leaderboard search-communities— Search Communities

Start using /explore now

Free tier — 30 requests, no credit card required.

Get free API key All endpoints →