r/popular — trending posts across Reddit right now
Get the current r/popular feed. See what's trending across all of Reddit in real time.
/popular Discover https://api.fetchlayer.dev/reddit/popular Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
limit integer optional Maximum number of posts to return. (default: 25)
pages integer optional How many pages of results to return, at most. Each page holds 25 results. If omitted, results continue until `limit` is reached (or the 45s time budget ends, returning partial results with `incompleteReason: "scrape_timeout"`), billed as `ceil(items returned / 25)`. If passed, results are capped at that many pages and billed per page actually returned (see `pagesScraped` in the response).
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
popular
r/popular — trending posts across Reddit right now
requestedUrl string The Reddit URL the request was for.
finalUrl string Final URL after redirects.
listingType string Always popular for a successful response.
items[].id string | null Reddit post ID without the t3_ prefix.
items[].fullname string | null Reddit post fullname, including the t3_ prefix.
items[].subreddit string | null Subreddit name without the r/ prefix.
items[].subredditPrefixed string | null Subreddit name with the r/ prefix.
items[].author string | null Author username.
items[].title string | null Post title.
items[].permalink string | null Absolute URL of the Reddit comments page.
items[].shortlink string | null Short redd.it URL for the post.
items[].url string | null Absolute post content URL.
items[].domain string | null Hostname or Reddit domain associated with the post.
items[].createdAt string | null ISO 8601 creation timestamp.
items[].flair string | null Post flair text, or null when absent.
items[].score number | null Post score.
items[].scoreText string | null Score text as displayed by Reddit.
items[].commentCount number | null Comment count.
items[].commentCountText string | null Comment count text as displayed by Reddit.
items[].previewText string | null Text preview for self posts, or null when unavailable.
items[].thumbnailUrl string | null Post thumbnail URL, or null when unavailable.
items[].nsfw boolean Whether the post is marked NSFW.
items[].spoiler boolean Whether the post is marked as a spoiler.
items[].locked boolean Whether the post is locked.
items[].stickied boolean Whether the post is stickied.
items[].removed boolean | null true when the post has been removed or deleted, false when it is live, null when its status could not be read for this response (notes says how many). Reddit leaves removed posts out of this listing, so a listed post is false; null appears only when its status could not be read.
items[].removedByCategory string | null Almost always null: Reddit leaves removed posts out of this listing. When removed is true (rare), the same values as the post route.
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".
notes string[] Caveats about this result, for example how many posts had a removal status that could not be checked. When author flair could not be looked up for some commenters, it says so: those comments have authorFlair: null (unknown), not no flair.
items[].authorId string | null The author’s account id (t2_…), which stays the same if the username changes.
items[].subredditId string | null The subreddit’s id (t5_…).
items[].numCrossposts integer | null Exact number of crossposts; null when it could not be checked.
items[].postType string | null What kind of post it is: text, link, image, video or gallery; null when not known. Only text posts have a body.
items[].linkUrl string | null What a non-text post points to: the external site, the image, video or gallery, or a crosspost’s original. Null for a text post. url is unchanged.
Request
curl -X POST "https://api.fetchlayer.dev/reddit/popular" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"limit":10}'Response
{
"listingType": "popular",
"items": [
{
"id": "xyz",
"title": "Trending post",
"subreddit": "popular",
"author": "user123",
"score": 10000,
"commentCount": 2000,
"permalink": "https://www.reddit.com/r/popular/comments/xyz/",
"createdAt": "2026-08-13T03:00:00.000Z",
"nsfw": false,
"spoiler": false,
"locked": false,
"stickied": false
}
],
"itemCount": 1,
"pagesRequested": 1,
"pagesScraped": 1,
"transport": "reddit"
}