Community Leaderboard by Name V2

Fetch top posters or top commenters for a subreddit. Requires authenticated bearer — Reddit only returns ranking data for logged-in users.

GET /api/v2/community/q/leaderboard

Fetch top posters or top commenters for a subreddit. Requires authenticated bearer — Reddit only returns ranking data for logged-in users.

Query parameters

Name	Type	Required	Description
`name`	string	Yes	Subreddit name, r/name, or URL
`bearer`	string	No	Bearer token — auto-resolves from Token Vault
`limit`	string	No	Max users to return (default: 100, max: 1000)
`category`	string	No	top_posters or top_commenters (default: top_posters)
`proxy`	string	No	Custom proxy address (only needed if not using vault)

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v2/community/q/leaderboard?name=test&bearer=<bearer>&limit=25&category=<category>&proxy=<proxy>" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/community/q/leaderboard?name=test&bearer=<bearer>&limit=25&category=<category>&proxy=<proxy>", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/community/q/leaderboard?name=test&bearer=<bearer>&limit=25&category=<category>&proxy=<proxy>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "success": true,
    "subreddit": "test",
    "categoryId": "top_posters",
    "category": {
      "id": "top_posters",
      "name": "Top Posters",
      "description": "Based on votes counted for the month.",
      "updateInterval": "Rankings updated daily",
      "lastUpdated": "Last updated: 19 hours ago"
    },
    "tiers": [
      {
        "title": "Top 1% Poster",
        "icon": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "scoreLabel": "Upvotes"
      }
    ],
    "users": [
      {
        "rank": "1",
        "username": "Anonymous",
        "userId": "t2_exampleu",
        "isDeleted": false,
        "score": "189",
        "scoreChange": null,
        "icon": null,
        "tier": "Top 1% Poster"
      },
      {
        "rank": "2",
        "username": "Ok_Resident_5022",
        "userId": "t2_exampleu",
        "isDeleted": false,
        "score": "153",
        "scoreChange": "+9",
        "icon": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "tier": "Top 1% Poster"
      }
    ],
    "count": 2
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "22h 47m"
  },
  "timestamp": "2026-04-29T08:59:30.912783+00:00"
}