Reddit API
Reddit 搜索 API
按查询词在所有子版块中搜索 Reddit 帖子，可设置排序和时间范围。用 after 游标分页。
POST/v1/run/reddit.search
可用率
99.88%
30d · 70,446 次调用
请求数
70,465
30d · 按周，近 12 周
响应时间
1.8s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `isArchived` 或 `media`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某条帖子确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。在分页遍历中，它只作用于第一页；后续页面沿用该页选定的数据源，按当时的报价计费。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"found": true,
"data": {
"posts": [
{
"id": "t3_1abc234",
"title": "What is the best mechanical keyboard under $150?",
"author": "keebenjoyer",
"score": 1842,
"numComments": 327,
"url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1abc234/",
"permalink": "/r/MechanicalKeyboards/comments/1abc234/",
"createdUtc": 1718200000,
"subreddit": "MechanicalKeyboards"
}
],
"nextCursor": "t3_1abc234"
}
}响应类型定义
interface RedditSearchResponse {
data: {
nextCursor: string | null;
posts: {
author: string;
authorId?: string;
createdUtc: number;
id: string;
isArchived?: boolean;
isLocked?: boolean;
media?: {
height?: number;
type: string;
url: string;
videoUrl?: string;
width?: number;
}[];
nsfw?: boolean;
numComments: number;
permalink: string;
score: number;
selftext?: string;
subreddit: string;
title: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/reddit.search
curl -X POST https://api.getanyapi.com/v1/run/reddit.search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"best mechanical keyboard","sort":"relevance","timeframe":"month"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "best mechanical keyboard"在整个 Reddit 中进行自由文本搜索。字符串内支持 Reddit 的字段运算符：subreddit:<name> 限定到一个子版块，author:<user>、title:<text>、selftext:<text>、self:yes|no、nsfw:yes|no，以及布尔运算 AND/OR/NOT。要限定到单个子版块，可以在这里使用 subreddit:<name>，或用 reddit.subreddit_posts SKU 获取普通的子版块列表。 |
| cursor | string | 来自上一次响应 nextCursor 的不透明分页游标。获取第一页时省略；传入它可获取下一页结果。 |
| requireFields | array | 可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `isArchived` 或 `media`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某条帖子确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。在分页遍历中，它只作用于第一页；后续页面沿用该页选定的数据源，按当时的报价计费。 |
| sort | enum | "relevance"结果排序方式。 |
| timeframe | enum | "month"结果的时间范围。 |
| 响应 | ||
| found | boolean | true |
| data | object | |
| data.posts | array | |
| data.posts[].id | string | "t3_1abc234" |
| data.posts[].title | string | "What is the best mechanical keyboard under $150?" |
| data.posts[].author | string | "keebenjoyer" |
| data.posts[].score | number | 1842 |
| data.posts[].numComments | number | 327 |
| data.posts[].url | string | "https://www.reddit.com/r/MechanicalKeyboards/comments/1abc234/" |
| data.posts[].permalink | string | "/r/MechanicalKeyboards/comments/1abc234/" |
| data.posts[].createdUtc | number | 1718200000 |
| data.posts[].subreddit | string | "MechanicalKeyboards" |
| data.nextCursor | string | "t3_1abc234" |
| 价格 | ||
| 每次请求价格 | USD | US$0.00038 |
| 价格（/千次请求） | USD | US$0.38 |
常见问题
关于 Reddit 搜索 API
AnyAPI 的 Reddit 搜索 API 只需一次 POST 请求 /v1/run/reddit.search，就以统一格式的 JSON 返回 Reddit 数据。按查询词在所有子版块中搜索 Reddit 帖子，可设置排序和时间范围。用 after 游标分页。AnyAPI 会在 4 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.38 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Reddit 搜索 API 调用中有 99.9% 成功，响应时间中位数为 1.8 秒，共测量 70,446 次调用。
费用：每千次请求 US$0.38 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。
按查询词在所有子版块中搜索 Reddit 帖子，可设置排序和时间范围。用 after 游标分页。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。
过去 30 天，通过 AnyAPI 发起的 Reddit 搜索 API 调用中有 99.9% 成功，响应时间中位数为 1.8 秒，共测量 70,446 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。