Popular communities leaderboard
Get Reddit’s popular-community listing with names, descriptions, URLs, metadata text, and NSFW status.
/leaderboard Discover https://api.fetchlayer.dev/reddit/leaderboard 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"
}