/v1/comments"platform": "x"X 评论接口
一条帖子下的评论。
取任意公开 X 帖子下的评论,拿回正文、点赞数、回复数和时间:用 HTTP 取 JSON,或在 AI 客户端里通过 MCP 调用。X 评论 API(数据接口)每次调用 2 积分(约 $0.004–$0.0067),失败不扣,返回格式和其他调用相同。最近实测:2026-11-05。
最近更新:
limit: 100,一次调用自动翻页,最多 3 页、6 积分。够数或没有下一页就停,用不上的页不扣,失败的页也不扣。读 1,000 条约 58 积分,约 ¥1.4($0.19)。每日监控:对你的 AI 说“每天帮我盯着”,这个调用每天自己跑,只把新内容发给你,一个月最多 62 积分,约 ¥1.5($0.21)。 看怎么设
调用 X 评论,你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了 6 条,下面是第一条的每个字段。名称和正文在示例里去掉了,数字是录制时的真实值。
近 7 天真实调用 93 次,成功 100%,中位 2.1 秒,通常 36 条(数据截至 2026-11-05)。
给 AI 读更省:同一份录制数据(6 条),平台原始 JSON 约 3,463 token,这个接口返回约 1,135 token,少 67%(2026-11-06 实测)。 测量方法
| 字段 | 录制时的值 |
|---|---|
| url | 示例里已去掉 |
| text | 示例里已去掉 |
| published_at | 2026-10-08T14:10:01.000Z |
| author.label | anonymous_1 |
| metrics.likes | 14 |
| reply_count | 1 |
| content_id | 示例里已去掉 |
| parent_id | null:X 给不了 |
| root_id | null:X 给不了 |
每次 2 积分(≈ $0.004–$0.0067),$10 约够 1,500 次。
X 评论的请求与返回
curl https://api.socialtoai.com/v1/comments \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x", "id": "2108198226532708497" }'import osimport uuidimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/comments", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "platform": "x", "id": "2108198226532708497", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。读一下这条 X 帖子下的评论:2108198226532708497# 你的 AI 会调用 comments 工具,参数是:{ "platform": "x", "id": "2108198226532708497"}{ "platform": "x", "status": "ok", "items": [ { "platform": "x", "id": "…", "ref": "…", "approx": [], "type": "comment", "url": "https://example.com/…", "text": "…", "published_at": "2026-10-08T14:10:01.000Z", "author": { "label": "anonymous_1" }, "metrics": { "likes": 14 }, "reply_count": 1, "content_id": "…", "parent_id": null, "root_id": null } ], "unavailable": ["parent_id", "root_id"], "page": { "has_more": false }, "cost_credits": 2}示例里的名称和正文已去掉,数字是录制时的真实值。
X 评论的参数。
3 个,2 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| platform | string | 必填 | — | 这一页固定填 "x"。 |
| id | string | 必填 | — | 帖子编号,一串数字 |
| cursor | string | 选填 | — | 填上一次返回的 page.cursor,取下一页。 |
这些值从哪里拿。
X 评论返回的字段。
X 给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].url | string | 评论的链接,平台有才给。 |
| items[].text | string | 评论原文。 |
| items[].published_at | string | 发布时间,ISO 8601(UTC)。 |
| items[].author.label | string | 匿名标记,在同一次返回里保持一致;写的人不具名。 |
| items[].metrics.likes | integer | 点赞数。 |
| items[].reply_count | integer | 回复数。 |
| items[].content_id | string | 评论所在内容的编号。 |
| items[].parent_id | string始终 null | 它直接回复的那条评论;一级评论为 null。 |
| items[].root_id | string始终 null | 所在回复串的一级评论。 |
nullX 给不了的字段null 的意思是“X 没给这个值”,不要当成 0。这些字段在这个调用里始终是 null:
parent_id它直接回复的那条评论;一级评论为 null。root_id所在回复串的一级评论。
和 TikTok 评论比,这个调用多给评论链接。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
X 评论的翻页与计费。
每把 Key 每秒 5 次,购买后 20 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
首屏的“最近实测”是最近一次真实调用成功的日子。每次调用从平台读取,返回里的 fetched_at 是读取时间;同一把 Key 5 分钟内重发完全相同的请求算重放(replayed: true),0 积分,返回第一次读到的结果。
这些数字只来自真实调用,每天算一次,不含我们自己的账户:同一账户当天重复发同一请求只按最后一次算,对象不存在、参数不对不算失败,不足 20 次的接口不显示。
接好 MCP 后,这样问就会用到 X 评论。
读一下这条 X 帖子下的评论:2108198226532708497
2 积分comments {"platform":"x","id":"2108198226532708497"}在 X 上搜和“weather forecast”有关的帖子,再对前 3 个结果:读一下这条 X 帖子下的评论。
8 积分search {"platform":"x","query":"weather forecast"}comments {"platform":"x","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务(https://mcp.socialtoai.com/mcp)完成这件事:读一下这条 X 帖子下的评论:2108198226532708497调用 comments 工具,参数是 {"platform":"x","id":"2108198226532708497"}。必填:id。要多条就传 limit(比如 limit=100,最多 3 页),一次调用自动翻页,不用自己一页页取;每页 2 积分,用不上的页不扣。开跑前先算出总共要多少积分,问我同意了再调用。如果还没接上 SocialToAI,告诉我怎么接,不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接,最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key:在 Claude 和 ChatGPT 里登录授权,其他客户端把 Key 放在请求头里。
这些工具运行时会调用它。
用到它的工作场景。
同一个调用,换个平台。
全部平台和价格/v1/comments{ "platform": "x", "id": "2108198226532708497" }2 积分每次调用接着看。
官方能做什么、谁能申请、多少钱,带来源。
哪些平台能取评论、每页多少条、多少积分。
X 官方价格(带来源),以及改为按次读 X
评论在说什么,带原话:用工具还是让 AI 读,各平台价格,一次录制
让你的 AI 直接读 X。