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

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.