Reddit Leaderboard API - Top Communities

Popular communities leaderboard

Get Reddit’s popular-community listing with names, descriptions, URLs, metadata text, and NSFW status.

POST /leaderboard Discover
https://api.fetchlayer.dev/reddit/leaderboard
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

limit integer optional

Number of communities. (default: 25)

pages integer optional

How many pages of results to return, at most. Each page is billed as one, so the credits a request costs equal the pages it actually returns (see `pagesScraped` in the response). (default: 1)

after string optional

Continue where a previous response stopped: pass the after of its nextPageUrl (the last result’s fullname), or POST the nextPageUrl itself.

Response Fields

leaderboard

Popular communities leaderboard

requestedUrl string

The Reddit URL the request was for.

finalUrl string

Final URL after redirects.

listingType string

Always leaderboard for a successful response.

items[].subreddit string | null

Subreddit name without the r/ prefix.

items[].subredditPrefixed string | null

Subreddit name with the r/ prefix.

items[].title string | null

Community display title.

items[].descriptionText string

Plain-text community description.

items[].descriptionHtml string | null

HTML community description when available.

items[].url string | null

Absolute subreddit URL.

items[].metaText string | null

Metadata text displayed by Reddit.

items[].nsfw boolean

Whether the community marks itself as 18+ (NSFW).

listingTitle string | null

Display title of the listing, or null when unavailable.

itemCount number

Number of entries returned in items.

nextPageUrl string | null

The next page’s address, or null at the end. On endpoints that take `after` it is an api.fetchlayer.dev address: POST it with your key to get the next page (a body is optional; fields you send override the address), or pass its `after` parameter as `after`.

prevPageUrl string | null

The previous page’s address (its `before` parameter is the cursor), or null.

pagesRequested number

Number of pages requested.

pagesScraped number

Pages of results returned. This is what the request is billed at: 1 credit per page actually returned, never per page requested.

scrapedAt string

ISO 8601 time the result was produced.

transport string

The data source: always the platform id, "reddit".

Request

curl -X POST "https://api.fetchlayer.dev/reddit/leaderboard" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"limit":10}'

Response

{
  "listingType": "leaderboard",
  "items": [
    {
      "subreddit": "programming",
      "subredditPrefixed": "r/programming",
      "title": "Programming",
      "descriptionText": "Computer Programming",
      "url": "https://www.reddit.com/r/programming/",
      "metaText": "Popular community",
      "nsfw": false
    }
  ],
  "itemCount": 1,
  "pagesRequested": 1,
  "pagesScraped": 1,
  "transport": "reddit"
}
Product overview Reddit API: what it returns, pricing and use cases