raw.reddit.comments

Reddit 帖子评论

实时Beta不使用免费额度

GEThttps://api.qovia.ai/v1/raw/reddit/comments

帖子的评论树，按游标翻页，每页 8 条：几条一级评论连同 Reddit 在其下展开的回复，按 Reddit 的顺序平铺，带 depth（0 为一级评论）和 parent_cid（所回复的评论）；内容、得分、回复总数、时间（UTC）、是否置顶和评论者。可按 best（默认）、top、new、old 或 controversial 排序。Reddit 收起的回复带 replies_cursor，交给 raw.reddit.comment_replies 获取。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。帖子没有评论时返回空结果，帖子不存在时返回 404，均不计费。

价格: $0.001 / 次$1 / 千次 · 固定价格
计费: 成功且有结果才扣费不使用免费额度
权限: raw:redditAPI Key 需要这个 scope
限速: 仅账户限流账户每分钟上限

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

post_idstring必填

帖子 fullname（t3_ 开头，来自帖子详情、版块帖子或搜索的 extra.source_id）

格式^t3_[a-z0-9]{1,17}$

示例t3_1xbt833

sortstring · enum

排序：best（默认）、top 得分最高、new 最新、old 最早、controversial 争议最大

默认best可选值best · top · new · old · controversial

cursorstring

取上一页响应的 cursor；第一页不传

最多 2048 字至少 13 字格式^commenttree:[!-~]+$

curl 'https://api.qovia.ai/v1/raw/reddit/comments?post_id=t3_1xbt833' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "cid": "t1_19rg000ofri4j",
        "text": "And the Airbnb host subreddit is having a complete meltdown about it",
        "likes": 4571,
        "reply_count": 126,
        "created_at": "2026-10-21T17:22:20+00:00",
        "pinned": false,
        "author": {
          "uid_hash": "299b37f83b60",
          "nickname": "example_user_1",
          "uid": "t2_00000001",
          "username": "example_user_1"
        },
        "depth": 0,
        "parent_cid": null,
        "replies_cursor": "commenttree:53e6639b,::1:ex:,WFr2?o%Pj"
      },
      {
        "cid": "t1_19rg04nkcanwl",
        "text": "They act like landlords instead of hospitality workers, so good. Hotels are better, people.",
        "likes": 3119,
        "reply_count": 54,
        "created_at": "2026-10-21T17:25:13+00:00",
        "pinned": false,
        "author": {
          "uid_hash": "8897faae40c1",
          "nickname": "example_user_2",
          "uid": "t2_00000002",
          "username": "example_user_2"
        },
        "depth": 1,
        "parent_cid": "t1_19rg000ofri4j",
        "replies_cursor": "commenttree:aa00d618,::2:ex:,WFsK-;LP&:(:#$C8^Ag"
      }
    ],
    "cursor": "commenttree:b0a55329,::0:ex:,WFq4W|n.A:':HRW7A3",
    "has_more": true,
    "total": 920,
    "prov": {
      "hash": "0x0520c1630b7a5f06",
      "ts": "2026-10-22T03:30:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.999000",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用（免费额度已用完，或接口不使用免费额度）。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key