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.
• 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.

Getting more than 1000 posts

Narrow the window rather than paging deeper. Each of these is a separate listing with its own ~1000 budget:

• Sort tabs: new, hot, top, rising, controversial, best each return a different listing.
• Timeframes: pair sort=top with t=hour|day|week|month|year|all to slice history into chunks that individually stay under the cap.
• Search: /api/reddit/search with a query scoped to the subreddit reaches posts a listing will not.

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,
      "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