Reddit API
Reddit Subreddit search API
Search posts within a single subreddit by query, sort and timeframe. Paginate with the cursor field.
POST/v1/run/reddit.subreddit_search
Uptime
99.15%
30d · 3,870 calls
Requests
3,871
30d · weekly, last 12 wks
Response
1.2s
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_1ghi890",
"title": "Quietest silent switches you have tried?",
"author": "lurkmoar",
"score": 612,
"numComments": 144,
"url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1ghi890/",
"permalink": "/r/MechanicalKeyboards/comments/1ghi890/",
"createdUtc": 1718160000,
"subreddit": "MechanicalKeyboards",
"nsfw": false
}
],
"nextCursor": "t3_1ghi890"
}
}Response interface
interface RedditSubredditSearchResponse {
data: {
nextCursor: string | null;
posts: {
author: string;
createdUtc: number;
id: string;
isArchived?: boolean;
isLocked?: boolean;
nsfw: 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_search
curl -X POST https://api.getanyapi.com/v1/run/reddit.subreddit_search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"subreddit":"MechanicalKeyboards","query":"silent switches"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| subreddit | string | "MechanicalKeyboards"Subreddit name without the r/ prefix (e.g. 'Fitness'). |
| cursor | string | Optional pagination token from a previous response. |
| query | string | "silent switches"Optional search query to match posts (e.g. 'push ups'). |
| 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 | string | Optional sort order: relevance, hot, top, new, comments. |
| timeframe | string | Optional time filter: all, year, month, week, day, hour. |
| Response | ||
| found | boolean | true |
| data | object | |
| data.posts | array | |
| data.posts[].id | string | "t3_1ghi890" |
| data.posts[].title | string | "Quietest silent switches you have tried?" |
| data.posts[].authorcan require | string | "lurkmoar" |
| data.posts[].scorecan require | number | 612 |
| data.posts[].numCommentscan require | number | 144 |
| data.posts[].url | string | "https://www.reddit.com/r/MechanicalKeyboards/comments/1ghi890/" |
| data.posts[].permalink | string | "/r/MechanicalKeyboards/comments/1ghi890/" |
| data.posts[].createdUtccan require | number | 1718160000 |
| data.posts[].subreddit | string | "MechanicalKeyboards" |
| data.posts[].nsfwcan require | boolean | false |
| data.nextCursorcan require | string | "t3_1ghi890" |
| Price | ||
| Price per request | USD | $0.00038 |
| Price /1k req | USD | $0.38 |
FAQ
About the Reddit Subreddit search API
The AnyAPI Reddit Subreddit search API returns Reddit subreddit search data as normalized JSON from one POST call to /v1/run/reddit.subreddit_search. Search posts within a single subreddit by query, sort and timeframe. Paginate with the cursor field. AnyAPI routes each request across 4 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.1% of Reddit subreddit search calls through AnyAPI succeeded, with a median response time of 1.2 seconds across 3,870 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.
Search posts within a single subreddit by query, sort and timeframe. Paginate with the cursor field. 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.1% of Reddit subreddit search calls through AnyAPI succeeded, with a median response time of 1.2 seconds across 3,870 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call