Posts from any subreddit — hot, new, top, rising
Retrieve the current post feed for a subreddit. Supports sorting by hot, new, top, rising, and controversial.
/community-posts Community https://api.fetchlayer.dev/reddit/community-posts Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
subreddit string required Subreddit name (without r/).
sort string optional Feed sort order: hot, new, top, rising, or controversial. (default: hot)
limit number optional Maximum number of posts to return. (default: 25)
time string | null optional Time filter for top and controversial sorts: hour, day, week, month, year, or all.
pages number optional Maximum number of feed pages to scrape. (default: 1)
Response Fields
community-posts
Posts from any subreddit — hot, new, top, rising
blocked boolean Whether Reddit returned a block or verification page.
blockReason string | null Machine-readable block reason when blocked is true; otherwise omitted.
blockedBodyText string | null Diagnostic text from a Reddit block page when blocked is true; otherwise omitted.
listingType string Always community-posts for a successful response.
pageTitle string Title of the scraped Reddit page.
requestedUrl string Reddit URL requested by the scraper.
fetchUrl string Normalized Reddit URL fetched by the scraper.
finalUrl string Final URL after redirects.
responseStatus number | null HTTP status returned by Reddit, or null when unavailable.
subreddit string | null Subreddit name without the r/ prefix.
subredditPrefixed string | null Subreddit name with the r/ prefix.
sort string Applied feed sort order.
time string | null Applied time filter, or null when none was supplied.
listingTitle string | null Display title of the subreddit listing.
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 the post has no flair.
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.
itemCount number Number of posts returned in items.
nextPageUrl string | null Next-page URL when available, otherwise null.
prevPageUrl string | null Previous-page URL when available, otherwise null.
pagesRequested number Number of pages requested.
pagesScraped number Number of pages successfully scraped.
scrapedAt string ISO 8601 timestamp for the scrape.
transport string Reddit page transport used for extraction.
Request
curl -X POST "https://api.fetchlayer.dev/reddit/community-posts" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"subreddit":"programming","sort":"top","limit":10,"time":"week"}'Response
{
"blocked": false,
"listingType": "community-posts",
"pageTitle": "Programming",
"requestedUrl": "https://www.reddit.com/r/programming/top/?t=week",
"fetchUrl": "https://www.reddit.com/r/programming/top/?t=week",
"finalUrl": "https://www.reddit.com/r/programming/top/?t=week",
"responseStatus": 200,
"subreddit": "programming",
"subredditPrefixed": "r/programming",
"sort": "top",
"time": "week",
"listingTitle": "Programming",
"items": [
{
"id": "xyz",
"fullname": "t3_xyz",
"subreddit": "programming",
"subredditPrefixed": "r/programming",
"title": "Example programming post",
"author": "coder123",
"score": 2500,
"scoreText": "2.5K",
"commentCount": 320,
"commentCountText": "320",
"permalink": "https://www.reddit.com/r/programming/comments/xyz/example_programming_post/",
"shortlink": "https://redd.it/xyz",
"url": "https://example.com/article",
"domain": "example.com",
"createdAt": "2026-08-13T03:00:00.000Z",
"flair": "Discussion",
"previewText": null,
"thumbnailUrl": null,
"nsfw": false,
"spoiler": false,
"locked": false,
"stickied": false
}
],
"itemCount": 1,
"nextPageUrl": null,
"prevPageUrl": null,
"pagesRequested": 1,
"pagesScraped": 1,
"scrapedAt": "2026-08-13T03:00:01.000Z",
"transport": "new-reddit-html"
}