贴吧楼中楼回复

实时Beta

GEThttps://api.qovia.ai/v1/raw/tieba/replies

某一层楼下面的楼中楼回复，每页 10 条，用 cursor 翻页（cursor 为 null 表示没有更多）。每条带作者昵称和 IP 属地；"回复某人 :" 的前缀会拆到 reply_to 里。post_id 取自 raw.tieba.thread 的 extra.posts[].pid。这层没有回复（或 post_id 不存在）时返回空结果，不计费。

常见用途：口碑与评论分析、舆情监测，比如找出用户最常夸和最常抱怨的点。

价格: $0.0015 / 次$1.5 / 千次每月超过 500 万次后 $1 / 千次
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:tiebaAPI Key 需要这个 scope
限速: 不限流不按账户或接口限制每分钟请求数

请求参数

作为查询参数发送

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

thread_idstring必填

帖子 ID

格式^[1-9][0-9]{0,19}$

示例10693684727

post_idstring必填

楼层 ID（帖子回复里的 pid）

格式^[1-9][0-9]{0,19}$

示例153488634022

cursorinteger

上一页返回的 cursor

默认0范围0–100000

curl 'https://api.qovia.ai/v1/raw/tieba/replies?thread_id=10693684727&post_id=153488634022' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "pid": "150000000101",
        "text": "不应该是先有誓约吗",
        "images": [],
        "created_at": "2026-05-06T11:15:11+08:00",
        "likes": 0,
        "reply_to": null,
        "author": {
          "uid_hash": "6c0d2a9e81f4",
          "user_id": "3234567890",
          "portrait": "tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h",
          "nickname": "夏末",
          "ip_location": "广东",
          "level": null
        }
      },
      {
        "pid": "150000000102",
        "text": "太初誓约哪有这么好出",
        "images": [],
        "created_at": "2026-05-06T12:20:05+08:00",
        "likes": 2,
        "reply_to": {
          "user_id": "3234567890",
          "nickname": "夏末",
          "portrait": "tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h"
        },
        "author": {
          "uid_hash": "0e5b7d31a9c2",
          "user_id": "4234567890",
          "portrait": "tb.1.7b20e5d9.Vt4cH8sJ1nK6pQ3wE9rU2f",
          "nickname": "星系",
          "ip_location": "广东",
          "level": null
        }
      }
    ],
    "cursor": 10,
    "has_more": true
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001500",
    "balance_usd": "9.998500",
    "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: …` 开头。
`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

请求参数

响应

错误码

贴吧的其他接口