Threads 评论 API

POST

接口健康状态

24h 健康值: 正常

健康 / 正常
可用
少量可用
基本不可用

24 小时趋势

30 天趋势

评论：返回列表；主要字段 id、url、text、author_username、author_name、author_is_verified。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 threads，action 填 comments。单价 $0.56 / 千次（每次 $0.000556），失败和空结果都不收费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

Threads 评论接口按帖子的完整链接 url 读取这条帖子下的评论，每条带正文 text、作者用户名和昵称、是否认证 author_is_verified、点赞数、评论数和发布时间。它回答「大家在这条帖子下说了什么」，适合做口碑观察、收集产品反馈，或者找出认证账号留下的评论。

reply_to 给出这条评论回复的是哪一条内容，内容详情那一页没有这个字段，用它把回复接回上一级。url 要填完整的帖子链接，形如 https://www.threads.com/@用户名/post/帖子短码。接口不保证返回所有嵌套层级，需要完整楼层结构时，别把结果当成全量。

AI 提示词

请帮我用 EveryInfra 的「Threads 评论」接口（threads/comments）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 threads，action 填 comments，参数放在 params 里。
- 必填参数：
  - url：post_detail / comments 的帖子完整链接，例如 https://www.threads.com/@用户名/post/帖子短码；comments 不保证返回所有嵌套层级。
- 可选参数：
  - limit：这次调用最多返回的条数，整数，至少为 1；不传按默认值，实际返回可能少于这个数。
- 返回一组记录，每条记录的主要字段：id、url、text、author_username、author_name、author_is_verified（作者是否已认证）、like_count、comment_count、reply_to（被回复的内容）、posted_at。
- 示例请求体：
{
  "platform": "threads",
  "action": "comments",
  "params": {
    "url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
  }
}
- 计费：$0.56 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`threads`	平台标识，固定值。
`action`	body	`string`	是	`comments`	能力标识，固定值。
`url`	body.params	`string`	是	-	post_detail / comments 的帖子完整链接，例如 https://www.threads.com/@用户名/post/帖子短码；comments 不保证返回所有嵌套层级。
`limit`	body.params	`integer (1–)`	否	-	这次调用最多返回的条数，整数，至少为 1；不传按默认值，实际返回可能少于这个数。

代码示例

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "threads",
  "action": "comments",
  "params": {
    "url": "https://www.threads.com/@openai/post/DW7RXR7EnRC"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

响应示例

json

{  "id": "req_…",  "platform": "threads",  "action": "comments",  "results": [    {      "id": "DW7R6s-Eu4u",      "url": "https://www.threads.com/@•••/post/DW7R6s-Eu4u",      "text": "Aw shit MIGHT have to downgrade Claude for that 10x plus. @openai help convince me haha. Make it irrefutable",      "author_username": "•••",      "author_name": "•••",      "author_is_verified": true,      "like_count": 5,      "comment_count": 0,      "reply_to": "openai",      "posted_at": "2026-04-09T21:37:07+00:00",      "platform": "threads"    },    {      "id": "DW7TiRME15N",      "url": "https://www.threads.com/@•••/post/DW7TiRME15N",      "text": "@••• and @••• must be winning bigly if you guys need to do this. Dropping ads in chats really breached trust as no one ever wants their chatbot to uae private discussions to help you place adverts and mint money!",      "author_username": "•••",      "author_name": "•••",      "author_is_verified": false,      "like_count": 0,      "comment_count": 1,      "reply_to": "openai",      "posted_at": "2026-04-09T21:51:16+00:00",      "platform": "threads"    }  ],  "count": 21,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。

字段	含义
`id`	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
`url`	该记录在原平台上的可访问链接。
`text`	正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
`author_username`	作者用户名（@handle），通常可用于拼 URL。
`author_name`	作者昵称（显示名）。
`author_is_verified`	作者是否已认证。
`like_count`	点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
`comment_count`	评论数。null 表示不公开，不等于 0。
`reply_to`	被回复的内容。
`posted_at`	发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

常见问题

评论能保证拿全吗？

不能保证。接口不保证返回所有嵌套层级，深层的回复可能不在结果里。统计评论总量时，别把返回的行数当成帖子的全部评论数；要核对帖子本身有多少评论，到内容详情里读帖子的评论数。

`reply_to` 有什么用？

它是被回复的内容，只有评论接口有。按它可以把一条回复归到它所回应的那条评论下面，整理成对话串。因为嵌套层级不保证齐全，回复链可能断；遇到 reply_to 指向的内容不在结果里，别当成错误。

评论接口和内容详情怎么配合？

两个接口用同一个帖子链接。内容详情返回一个对象，带浏览数、转发数、引用转发数、图片和话题标签；评论接口返回列表，每行是一条评论，多一个 reply_to。先用内容详情看帖子自己的热度，再用评论接口看大家说了什么。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码