POST/api/v1/leaderboardDiscover

Leaderboard

Fetch Reddit's official community leaderboards to discover which subreddits are currently growing fastest or are most active in specific categories.

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
category	string	No	The category to fetch (e.g., 'sports', 'gaming', 'news'). Default is all categories.
limit	number	No	Number of communities to return (max 100). Default: 25.

Code Examples

curl

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

TypeScript SDK

const leaders = await client.getLeaderboard({
  category: "gaming",
  limit: 5
});

Install the SDK →

Sample Response

{
  "communities": [
    {
      "name": "BaldursGate3",
      "rank": 1,
      "rankChange": 2,
      "subscribers": 1200000,
      "publicDescription": "The official subreddit for Baldur's Gate 3."
    },
    {
      "name": "gaming",
      "rank": 2,
      "rankChange": -1,
      "subscribers": 35000000,
      "publicDescription": "A subreddit for (almost) anything related to games - video games, board games, card games, etc."
    }
  ]
}

Common Use Cases

Identifying rapidly growing niche communities
Market research for trending topics
Discovering where active user bases are migrating

Credits

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

Related Tools & Guides

All developer tools →

Sandbox→

API Playground

Discover fastest growing Reddit communities.

Use Case→

Reddit API for Market Research

Identify rising niches and consumer communities.

Related Endpoints

explore— Explore Topics popular— Popular Feed

Start using /leaderboard now

Free tier — 30 requests, no credit card required.

Get free API key All endpoints →