raw.tieba.thread

贴吧帖子

实时Beta可用免费额度

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

帖子主楼（正文、作者、点赞收藏分享和回复数、所在吧）以及指定页的楼层回复，每页约 15 层，按楼层正序。楼层作者的昵称、等级和 IP 属地已关联好；楼中楼回复用 raw.tieba.replies 获取。帖子已删除或不存在时返回 404，页码超过总页数时返回空结果，均不计费。

价格: $0.0015 / 次$1.5 / 千次每月超过 500 万次后 $1 / 千次
计费: 成功且有结果才扣费优先用免费额度
权限: raw:tiebaAPI Key 需要这个 scope
限速: 全局 5 次/秒所有用户合计，另有账户每分钟上限

请求参数

作为查询参数发送

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

thread_idstring必填

帖子 ID（tieba.baidu.com/p/ 后面的数字）

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

示例10693684727

pageinteger

回复页码，从 1 开始；只有第 1 页带主楼全文和图片

默认1范围1–10000

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

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "id": "soc_tie_3f9a1c27b04e",
    "src": "social",
    "platform": "tieba",
    "lang": "zh-CN",
    "text": "觉醒套和混搭传说五到底先做哪个？[小乖]黄金乡才传说二，有没有必要现在换。",
    "author": {
      "uid_hash": "8d41e0a7c2f5",
      "user_id": "1234567890",
      "portrait": "tb.1.5a3c9e10.Qx7nB2kLmP4rT8vW1yZ0aA",
      "nickname": "阿拉德老玩家",
      "ip_location": "湖北",
      "level": 9,
      "followers": null
    },
    "metrics": {
      "replies": 31,
      "likes": 7,
      "saves": 1,
      "shares": 0
    },
    "extra": {
      "source_id": "10000000001",
      "title": "问个套装问题",
      "url": "https://tieba.baidu.com/p/10000000001",
      "forum": {
        "id": "81570",
        "name": "地下城与勇士",
        "category": "游戏",
        "subcategory": "网络游戏"
      },
      "published_at": "2026-05-06T09:45:46+08:00",
      "images": [
        "https://tiebapic.baidu.com/forum/pic/item/0000example.jpg"
      ],
      "posts": [
        {
          "pid": "150000000002",
          "floor": 2,
          "text": "等新团本出来再考虑，混搭传说五够打现阶段的本了",
          "images": [],
          "created_at": "2026-05-06T09:47:39+08:00",
          "likes": 0,
          "reply_count": 3,
          "author": {
            "uid_hash": "2b7f90c13e6d",
            "user_id": "2234567890",
            "portrait": "tb.1.9e2d4b61.Hn3sK8pQ2wX5vC7mZ1rT4g",
            "nickname": "雷阵雨",
            "ip_location": "浙江",
            "level": 10
          }
        }
      ],
      "page": {
        "current": 1,
        "total": 2,
        "has_more": true
      }
    },
    "prov": {
      "hash": "0x0f1e2d3c4b5a6978",
      "ts": "2026-10-20T12:00:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001500",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "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: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`endpoint_busy`可重试	429	不扣费	这个接口所有用户合计的每秒请求已满，1 秒后重试；不占你的每分钟额度。
`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