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
99.37%
30d · 6,069 calls
Requests
6,135
30d · weekly, last 12 wks
Response
1.8s
median · 30d
Provider network
Providers ranked by traffic
Try it
Make your first request
requireFieldsarrayOptional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isArchived` or `selftext`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted.
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;
isArchived?: boolean;
isLocked?: boolean;
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-16 · uptime and latency measured over 30dPOST /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"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| subreddit | string | "MechanicalKeyboards"Subreddit name without the leading r/ (e.g. "golang"). |
| after | string | Legacy pagination alias. Prefer `cursor`; omit both fields for the first page. |
| cursor | string | Opaque pagination cursor from a previous response's `nextCursor`; omit for the first page. |
| limit | integer | Requested 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`. |
| requireFields | array | Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isArchived` or `selftext`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted. |
| sort | enum | "hot"Listing sort order. |
| timeframe | enum | Time 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 | ||
| found | boolean | true |
| data | object | |
| data.posts | array | |
| data.posts[].id | string | "t3_1def567" |
| data.posts[].title | string | "My first custom build is finally done" |
| data.posts[].author | string | "soldernoob" |
| data.posts[].scorecan require | number | 5412 |
| data.posts[].numCommentscan require | number | 218 |
| data.posts[].url | string | "https://www.reddit.com/r/MechanicalKeyboards/comments/1def567/" |
| data.posts[].permalink | string | "/r/MechanicalKeyboards/comments/1def567/" |
| data.posts[].createdUtc | number | 1718180000 |
| data.posts[].subreddit | string | "MechanicalKeyboards" |
| data.nextCursorcan require | string | "t3_1def567" |
| Price | ||
| Price per request | USD | $0.00038 |
| Price /1k req | USD | $0.38 |
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.38 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.4% of Reddit subreddit posts calls through AnyAPI succeeded, with a median response time of 1.8 seconds across 6,069 measured calls.
It costs from $0.38 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, 99.4% of Reddit subreddit posts calls through AnyAPI succeeded, with a median response time of 1.8 seconds across 6,069 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call