Get a Subreddit's Top Posts by Timeframe

Top posts in a subreddit by timeframe. Alias for /api/reddit/posts?sort=top.

Path Parameters

Query Parameters

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:

• t takes day, week, month, year, all, each its own listing.
• 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:

• Each timeframe really is a separate listing: t=week and t=all shared 0 of 100 posts on both r/programming and r/AskReddit.
• Adjacent windows overlap only partly, so they are worth walking rather than picking one: t=week against t=month shared 27 of 62 on r/programming and 18 of 100 on r/AskReddit.
• Three timeframes returned 282 distinct posts out of 300 slots on r/AskReddit, against 100 from a single call.

Example

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

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

import requests

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

Response Shape

Same shape as /api/reddit/posts, posts: [...] + after cursor. See that page for the per-post field reference (upvotes, comments, link_url, is_crosspost, crosspost_origin, etc.).

When after comes back empty

An empty cursor means there is no next page to ask for. It does not always mean you have every post: Reddit often stops serving a busy listing long before it runs out. Paging r/all on 2026-08-14 stopped after 400 posts covering about a minute of a feed that plainly holds more.

The response tells you which happened. When after is null it also carries listing_status, which reads complete, truncated or unknown. Only complete means you have everything; treat the other two as a partial answer and widen your search rather than stopping. The full field list and what to do about each answer is in Pagination depth.