跳到正文
Reddit 评论回复
raw.reddit.comment_replies

Reddit 评论回复

实时Beta:接口和返回字段仍可能调整不使用免费额度
GEThttps://api.qovia.ai/v1/raw/reddit/comment_replies

某条评论下被 Reddit 收起的回复(楼中楼),按游标翻页,每页最多 8 条,与评论接口一样平铺成树:内容、得分、回复总数、时间(UTC)、depth、parent_cid、是否置顶和回复者。 cursor 必填:第一页传评论的 replies_cursor(来自 raw.reddit.comments 或本接口),之后传上一页返回的 cursor,has_more 为 false 时停止。 cursor 无效或没有更多回复时返回空结果,帖子不存在时返回 404,均不计费。

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

请求参数

作为查询参数发送

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

post_idstring必填

评论所在帖子的 fullname(t3_ 开头)

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

示例t3_1xbt833

cursorstring必填

第一页传评论的 replies_cursor,之后传上一页响应的 cursor

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

示例commenttree:1032b8a8,::1:ex:,WFs(EBkw2

sortstring · enum

排序:best(默认)、top 得分最高、new 最新、old 最早、controversial 争议最大

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

响应

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

响应结构详解

错误码

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

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

全部错误码
在浏览器里直接调用

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