Fetch Posts From Any Subreddit by Sort

Posts from a subreddit. Supports all Reddit sort tabs: New / Hot / Top / Rising / Controversial / Best.

Query Parameters

Pagination depth

This section is the reference for every listing and search endpoint on this API, not just this one. They all issue the same kind of cursor and all publish the same exhaustion fields, so the other endpoint pages link here rather than repeating it. The one exception is a post's comment thread, which is a tree rather than a paged listing and is covered on its own page.

Reddit caps a single listing at roughly 1000 posts. Page past that and after comes back null, even when the subreddit plainly holds more history.

This is a Reddit platform limit, not a limit we add, and it applies to every client hitting a listing, including reddit.com itself. When Reddit stops issuing a cursor, pagination ends.

Measured on r/stocks, 100 posts per page:

The cap is not the only reason a listing stops, and busy feeds stop far sooner. Paging r/all with sort=new on 2026-08-14 terminated after 400 posts spanning 67 seconds of Reddit, and four sweeps the previous day stopped at 153, 384, 400 and 383 posts. None of those is the end of the data, and no count threshold separates them from a subreddit that genuinely holds a few hundred posts.

So when after comes back null, read the exhaustion fields below rather than inferring an answer from the count.

Exhaustion fields

When after is null, the response carries these extra fields:

listing_status answers the only question a paging client has:

• complete means the whole run came back in under one page: you asked for 100 and got fewer, and Reddit then stopped. Nothing was ever served whole, so there is no cut-off story competing with the obvious reading, and no older posts are expected in this listing. The first page coming back EMPTY is the same verdict (exhausted_reason: empty_listing): an account with no submissions, a query with no hits, a subreddit with nothing under this sort. There is no next page to ask for; change what you ask for instead.
• truncated means you reached Reddit's ~1000 cap. More history exists and this listing cannot reach it.
• unknown means we cannot tell, and we will not guess. Do not treat unknown as the end of the data. Three things land here: Reddit stopped on an exact page boundary; you paged with a raw Reddit token so we never knew your depth; or Reddit stopped part way through a page after already serving at least one full page (exhausted_reason: short_page_after_full_pages).

For both truncated and unknown, widen across listings rather than paging deeper into this one.

Paging past Reddit's cap

Reddit closes a single listing near 1000 items and then stops issuing a cursor, so listing_status: truncated is Reddit's limit rather than the end of the data. Every distinct combination of parameters you send is a separate listing with its own budget, so widen across listings rather than paging deeper into one.

What you can vary here:

• sort takes new, hot, top, rising, controversial, best, each with its own cursor.
• t takes hour, day, week, month, year, all. We forward it only on sort=top and sort=controversial and drop it on the other sorts, so sort=new&t=week and sort=new&t=all are the same request.
• Search is a different listing again: /api/reddit/search with a query scoped to the subreddit reaches posts a listing will not.

Which of those actually widen, measured against the live API 2026-09-05, at limit=100:

• sort=top and sort=controversial are the axes that reliably reach older posts: on r/programming t=week and t=all shared 0 of 100 posts, and sort=top shared 0 of 100 with sort=new. Paired with six timeframes that is twelve listings that barely overlap.
• new, hot and best are all recency-ordered, so how much they overlap depends on how fast the subreddit moves. On r/programming hot shared 99 of 100 posts with new; on r/AskReddit only 8 of 100. Do not count them as three independent budgets on a quiet subreddit.
• rising returns about 25 items however large a limit you ask for.
• Across seven variants r/AskReddit returned 491 distinct posts where a single listing returns 100.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/posts?subreddit=ClaudeCode&sort=top&t=week"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/posts?subreddit=ClaudeCode&sort=top&t=week",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/posts",
    params={"subreddit": "ClaudeCode", "sort": "top", "t": "week"},
    headers={"Authorization": "Bearer TOKEN"},
)

Response Shape

{
  "posts": [
    {
      "id": "1tkez6e",
      "name": "t3_1tkez6e",
      "title": "...",
      "author": "user123",
      "author_info": {
        "fullname": "t2_ugmf7dmn",
        "premium": false,
        "is_blocked": false,
        "flair": null
      },
      "permalink": "/r/ClaudeCode/comments/1tkez6e/...",
      "url": "https://reddit.com/r/ClaudeCode/comments/1tkez6e/...",
      "link_url": "https://i.redd.it/ec3ynsn66n2h1.png",
      "text": "",
      "subreddit": "ClaudeCode",
      "upvotes": 42,
      "comments": 12,
      "upvote_ratio": 0.96,
      "over_18": false,
      "stickied": false,
      "locked": false,
      "spoiler": false,
      "is_self": false,
      "link_flair_text": "Discussion",
      "link_flair_template_id": "a1b2c3d4-0000-11ee-9e7e-0e8b0f1a2b3c",
      "is_crosspost": true,
      "crosspost_origin": {
        "id": "1tkbqvk",
        "name": "t3_1tkbqvk",
        "title": "...",
        "author": "Agitated_Usual7089",
        "subreddit": "Class12thBoard",
        "permalink": "/r/Class12thBoard/comments/1tkbqvk/...",
        "url": "https://reddit.com/r/Class12thBoard/comments/1tkbqvk/...",
        "link_url": null,
        "text": "...",
        "created_utc": 1779435116,
        "created": "2026-05-22T07:31:56.000Z"
      },
      "created_utc": 1779445765,
      "created": "2026-05-22T10:29:25.000Z"
    }
  ],
  "after": "t3_xyz"
}

Response Fields