Reddit API

Reddit Subreddit posts API

Posts from a subreddit listing (hot, new, or top), with time windows. Paginate with the after cursor.

POST/v1/run/reddit.subreddit_posts
Uptime
100.00%
30d · 2,481 calls
Requests
2,488
30d · weekly, last 12 wks
Response
2.2s
median · 30d

Try it

Make your first request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "found": true,
  "data": {
    "posts": [
      {
        "id": "t3_1def567",
        "title": "My first custom build is finally done",
        "author": "soldernoob",
        "score": 5412,
        "numComments": 218,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1def567/",
        "permalink": "/r/MechanicalKeyboards/comments/1def567/",
        "createdUtc": 1718180000,
        "subreddit": "MechanicalKeyboards"
      }
    ],
    "nextCursor": "t3_1def567"
  }
}
Response interface
interface RedditSubredditPostsResponse {
  data: {
    nextCursor: string | null;
    posts: {
      author: string;
      createdUtc: number;
      id: string;
      numComments: number;
      permalink: string;
      score: number;
      selftext?: string;
      subreddit: string;
      title: string;
      url: string;
    }[];
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-12 · uptime and latency measured over 30d
POST /v1/run/reddit.subreddit_posts
curl -X POST https://api.getanyapi.com/v1/run/reddit.subreddit_posts \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subreddit":"MechanicalKeyboards","sort":"hot"}'
FieldTypeExample value
Request body
subredditstring"MechanicalKeyboards"Subreddit name without the leading r/ (e.g. "golang").
afterstringLegacy pagination alias. Prefer `cursor`; omit both fields for the first page.
cursorstringOpaque pagination cursor from a previous response's `nextCursor`; omit for the first page.
limitintegerRequested number of posts. Note: the upstream returns one page (about 25 posts) per call; values larger than a page are not delivered in a single response. To fetch more, pass `nextCursor` back as `cursor`.
sortenum"hot"Listing sort order.
timeframeenumTime window, applied when sort is "top" (e.g. "year" for the year's top posts). Ignored for hot/new. Omit to default to the current day for top.
Response
foundbooleantrue
dataobject
data.postsarray
data.posts[].idstring"t3_1def567"
data.posts[].titlestring"My first custom build is finally done"
data.posts[].authorstring"soldernoob"
data.posts[].scorenumber5412
data.posts[].numCommentsnumber218
data.posts[].urlstring"https://www.reddit.com/r/MechanicalKeyboards/comments/1def567/"
data.posts[].permalinkstring"/r/MechanicalKeyboards/comments/1def567/"
data.posts[].createdUtcnumber1718180000
data.posts[].subredditstring"MechanicalKeyboards"
data.nextCursorstring"t3_1def567"
Price
Price per requestUSD$0.00045
Price /1k reqUSD$0.45

FAQ

About the Reddit Subreddit posts API

The AnyAPI Reddit Subreddit posts API returns Reddit subreddit posts data as normalized JSON from one POST call to /v1/run/reddit.subreddit_posts. Posts from a subreddit listing (hot, new, or top), with time windows. Paginate with the after cursor. AnyAPI routes each request across 3 sources and falls back automatically when one fails. It costs from $0.45 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Reddit subreddit posts calls through AnyAPI succeeded, with a median response time of 2.2 seconds across 2,481 measured calls.

It costs from $0.45 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Posts from a subreddit listing (hot, new, or top), with time windows. Paginate with the after cursor. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of Reddit subreddit posts calls through AnyAPI succeeded, with a median response time of 2.2 seconds across 2,481 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.