Reddit API

Reddit 子版块内搜索 API

在单个子版块内按查询词、排序和时间范围搜索帖子。用 cursor 字段分页。

POST/v1/run/reddit.subreddit_search
可用率
99.45%
30d · 6,014 次调用
请求数
6,031
30d · 按周,近 12 周
响应时间
1.2s
中位数 · 30d

试一试

发出你的第一个请求

requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `isArchived` 或 `selftext`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条帖子确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。在分页遍历中,它只作用于第一页;后续页面沿用该页选定的数据源,按当时的报价计费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "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"
  }
}
响应类型定义
interface RedditSubredditSearchResponse {
  data: {
    nextCursor: string | null;
    posts: {
      author: string;
      authorId?: 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;
  reason?: "not_found";
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /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"}'
字段类型示例值
请求体
subredditstring"MechanicalKeyboards"子版块名称,不带 r/ 前缀(例如 'Fitness')。
cursorstring可选的分页令牌,来自上一次响应。
querystring"silent switches"可选的搜索查询,用于匹配帖子(例如 'push ups')。
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `isArchived` 或 `selftext`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某条帖子确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。在分页遍历中,它只作用于第一页;后续页面沿用该页选定的数据源,按当时的报价计费。
sortenum可选的排序方式:relevance、hot、top、new、comments。
timeframeenum可选的时间筛选:all、year、month、week、day、hour。
响应
foundbooleantrue
dataobject
data.postsarray
data.posts[].idstring"t3_1ghi890"
data.posts[].titlestring"Quietest silent switches you have tried?"
data.posts[].authorstring"lurkmoar"
data.posts[].scorenumber612
data.posts[].numCommentsnumber144
data.posts[].urlstring"https://www.reddit.com/r/MechanicalKeyboards/comments/1ghi890/"
data.posts[].permalinkstring"/r/MechanicalKeyboards/comments/1ghi890/"
data.posts[].createdUtcnumber1718160000
data.posts[].subredditstring"MechanicalKeyboards"
data.posts[].nsfwbooleanfalse
data.nextCursorstring"t3_1ghi890"
价格
每次请求价格USDUS$0.00038
价格(/千次请求)USDUS$0.38

常见问题

关于 Reddit 子版块内搜索 API

AnyAPI 的 Reddit 子版块内搜索 API 只需一次 POST 请求 /v1/run/reddit.subreddit_search,就以统一格式的 JSON 返回 Reddit 数据。在单个子版块内按查询词、排序和时间范围搜索帖子。用 cursor 字段分页。AnyAPI 会在 5 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.38 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Reddit 子版块内搜索 API 调用中有 99.5% 成功,响应时间中位数为 1.2 秒,共测量 6,014 次调用。

费用:每千次请求 US$0.38 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

在单个子版块内按查询词、排序和时间范围搜索帖子。用 cursor 字段分页。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Reddit 子版块内搜索 API 调用中有 99.5% 成功,响应时间中位数为 1.2 秒,共测量 6,014 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。