Threads 数据 API

通过 12 个需要鉴权的 Threads 接口查询用户资料、帖子、回复、转发、评论及搜索结果。

鉴权

在 Authorization 请求头中发送 API Hop API Key。访问取决于已启用的网关及 API Key 权限，文档不代表生产环境已开放。

Authorization: Bearer YOUR_API_KEY

请求

使用 GET 查询参数，不接受请求体。未知、重复或非法字段会被拒绝。ID 须保留为字符串，包括超出 JavaScript 安全整数范围的值。请求超时为 60 秒，不会自动重试。

curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"

响应

保留原始 JSON code/data 结构及数字精度。成功要求 code=200 且 data 非 null。HTTP 200 中的业务错误仍视为失败。各接口响应结构不同；以下为说明性示例，不是实时响应。

{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}

计费

默认按每次成功请求 $0.002（2000 credits）计费，包括成功返回的空数组或空对象，不按条数计费。账户专属价格优先。上游失败会释放预占；结算失败返回错误，不会再次调用上游。

分页限制

用户帖子、转发、回复、帖子评论、热门搜索及最新搜索不支持分页。end_cursor 是无效的保留字段，请勿根据 next_cursor 或 has_more 请求后续页。用户列表仅返回当前可得的一批数据（约 25 条），并非完整历史。所有接口均不会自动追加抓取。

错误

HTTP 400：参数错误；401：鉴权失败；402：余额不足；403：无访问权限；405：方法不支持；408：请求取消；429：限流；5xx：服务或上游错误，其中 504 表示超时。排查时请保留 X-Request-Id。

接口参考

完整接口参考

来源

于 2026-10-31 核对官方 OpenAPI V5.3.2 和端点价格。仅出现在价目表中的 fetch_post_id_from_url 不在 OpenAPI 中，因此不纳入接入范围。

TikHub · OpenAPI · Prices