X API 数据接口
帖子、评论、账号、热榜。
X API（数据接口）可以搜帖子，读帖子详情、评论、账号资料、账号发布的帖子和热榜，不用登录 X 账号，也不用提供 Cookie。每次调用 1 到 6 积分（低至 $0.002），失败不扣。可以直接发 HTTP 请求，也可以通过 MCP 接到 AI 客户端里用。最近实测：2026-11-05。
6 个里 6 个动作可用
1 积分起每次调用
少 64% tokenAI 读到的，比平台原始 JSON（21 个接口实测）
最近实测：最近更新：
POST
/v1/search200 OK2 积分platform: "x" · query: "weather forecast"likes 238comments 37shares
nullcollects 145views 8,357reposts 121这里始终是 null：
titlemetrics.sharesis_pinnedpage下一页cursor
billing本次调用2 积分
示例数据录制的 20 条里的 1 条
6 个动作。
外加 13 个 X 独有的接口。
点开任意一行，看请求怎么写；完整的参数和返回字段在它自己的页面。
动作每次调用积分
搜索按关键词找帖子：正文、作者、点赞数、评论数、播放或阅读数和发布时间。/v1/search2 积分≈ $0.0067 · ¥0.05
请求里要带
platformquery另有 1 个选填参数还可以取
sort=latest按最新排序2 积分type=user搜账号5 积分登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x", "query": "weather forecast" }'POST /v1/searchKey 放在 Authorization 请求头里热榜现在的热榜：标题、名次和热度。/v1/trending6 积分≈ $0.02 · ¥0.14
cURL
curl https://api.socialtoai.com/v1/trending \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x" }'POST /v1/trendingKey 放在 Authorization 请求头里详情用编号或链接取一条帖子：正文、作者、点赞数、评论数、播放或阅读数和发布时间。/v1/detail1 积分≈ $0.0033 · ¥0.02
请求里要带
platformid 或 url还可以取
include=transcript视频的逐字稿2 积分登录后运行1 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x", "id": "2108198226532708497" }'POST /v1/detailKey 放在 Authorization 请求头里评论一条帖子下的评论：正文、点赞数、回复数和时间。/v1/comments2 积分≈ $0.0067 · ¥0.05
cURL
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" }'POST /v1/commentsKey 放在 Authorization 请求头里账号资料一个账号：名称、简介、粉丝数、关注数和作品数。/v1/user_profile1 积分≈ $0.0033 · ¥0.02
cURL
curl https://api.socialtoai.com/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x", "id": "11348282" }'POST /v1/user_profileKey 放在 Authorization 请求头里账号作品一个账号最近发布的帖子。/v1/user_posts2 积分≈ $0.0067 · ¥0.05
cURL
curl https://api.socialtoai.com/v1/user_posts \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x", "username": "NASA" }'POST /v1/user_postsKey 放在 Authorization 请求头里和 Reddit 比，X 的帖子多给作者粉丝数、收藏、转发、播放或浏览和话题标签，少给标题和分享；账号资料多给粉丝数和关注数。
X 独有 · 社区与列表每次调用积分
社群资料按社群编号取 X 社群的资料。x.community1 积分≈ $0.0033 · ¥0.02
按社群编号取 X 社群的资料：名称、简介、成员数、管理员人数、加入方式、创建时间。
请求里要带
id登录后运行1 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.community \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1493446837214187523" }'POST /v1/call/x.communityKey 放在 Authorization 请求头里社群帖子按社群编号取一页这个 X 社群里的帖子。x.community_posts4 积分≈ $0.013 · ¥0.1
cURL
curl https://api.socialtoai.com/v1/call/x.community_posts \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1539231166569410560" }'POST /v1/call/x.community_postsKey 放在 Authorization 请求头里列表帖子按列表编号取一页这个 X 列表时间线上的帖子，从最新的开始，每页约 100 条。x.list_posts2 积分≈ $0.0067 · ¥0.05
按列表编号取一页这个 X 列表时间线上的帖子，从最新的开始，每页约 100 条。
请求里要带
id登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.list_posts \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "84839422" }'POST /v1/call/x.list_postsKey 放在 Authorization 请求头里社群成员按社群编号取一页加入了这个 X 社群的账号，每页约 20 个。x.community_members5 积分≈ $0.017 · ¥0.12
按社群编号取一页加入了这个 X 社群的账号，每页约 20 个：账号名、显示名、简介、粉丝数、是否认证。
请求里要带
id登录后运行5 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.community_members \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1539231166569410560" }'POST /v1/call/x.community_membersKey 放在 Authorization 请求头里列表关注者按列表编号取关注了这个 X 列表的账号，最多 20 个。x.list_followers5 积分≈ $0.017 · ¥0.12
按列表编号取关注了这个 X 列表的账号，最多 20 个：账号名、显示名、简介、粉丝数、是否认证。只有这一页，不能往后翻。
请求里要带
id登录后运行5 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.list_followers \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "84839422" }'POST /v1/call/x.list_followersKey 放在 Authorization 请求头里列表成员按列表编号取一页这个 X 列表收录的账号，每页 20 个。x.list_members5 积分≈ $0.017 · ¥0.12
按列表编号取一页这个 X 列表收录的账号，每页 20 个：账号名、显示名、简介、粉丝数、是否认证。
请求里要带
id登录后运行5 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.list_members \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "84839422" }'POST /v1/call/x.list_membersKey 放在 Authorization 请求头里X 独有 · 内容与账号每次调用积分
长文详情按帖子编号取这条 X 帖子附带的长文。x.article2 积分≈ $0.0067 · ¥0.05
按帖子编号取这条 X 帖子附带的长文：标题、全文、作者、发布时间、点赞、回复和浏览数。
请求里要带
id登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.article \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1905545699552375179" }'POST /v1/call/x.articleKey 放在 Authorization 请求头里帖子引用列表按帖子编号取一页引用它的 X 帖子，可按时间或按热门排。x.quotes4 积分≈ $0.013 · ¥0.1
按帖子编号取一页引用它的 X 帖子，可按时间或按热门排。
请求里要带
id登录后运行4 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.quotes \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "2108662426606395572" }'POST /v1/call/x.quotesKey 放在 Authorization 请求头里帖子转推用户按帖子编号取一页转推了这条 X 帖子的账号。x.retweeters2 积分≈ $0.0067 · ¥0.05
按帖子编号取一页转推了这条 X 帖子的账号：账号名、显示名、简介、粉丝数。
请求里要带
id登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.retweeters \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "2108198226532708497" }'POST /v1/call/x.retweetersKey 放在 Authorization 请求头里帖子对话串按对话串里任意一条帖子的编号，取这条对话串的帖子。x.thread9 积分≈ $0.03 · ¥0.22
按对话串里任意一条帖子的编号，取这条对话串的帖子：主帖、作者的续帖和其中的回复。
请求里要带
id登录后运行9 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.thread \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "2108198226532708497" }'POST /v1/call/x.threadKey 放在 Authorization 请求头里用户粉丝列表按账号名取一页关注该 X 用户的账号，每页最多 200 个，从最新关注的开始。x.followers12 积分≈ $0.04 · ¥0.29
按账号名取一页关注该 X 用户的账号，每页最多 200 个，从最新关注的开始。
请求里要带
username登录后运行12 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.followers \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "username": "NASA" }'POST /v1/call/x.followersKey 放在 Authorization 请求头里用户关注列表按账号名取一页该 X 用户关注的账号，每页最多 200 个。x.following12 积分≈ $0.04 · ¥0.29
按账号名取一页该 X 用户关注的账号，每页最多 200 个。
请求里要带
username登录后运行12 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.following \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "username": "WHO" }'POST /v1/call/x.followingKey 放在 Authorization 请求头里用户提及按账号名取一页提及该 X 用户的帖子，从最新的开始。x.mentions4 积分≈ $0.013 · ¥0.1
按账号名取一页提及该 X 用户的帖子，从最新的开始。
请求里要带
username登录后运行4 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。
cURL
curl https://api.socialtoai.com/v1/call/x.mentions \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "username": "NASA" }'POST /v1/call/x.mentionsKey 放在 Authorization 请求头里办成一件事多少钱。
| 要做的事 | 怎么算 | 积分 | 约合 |
|---|---|---|---|
| 搜 1,000 条 X 结果 | 每页通常 20 条，50 页 | 100 积分 | 约 ¥2.4（$0.33） |
| 读 1,000 条 X 评论 | 每页通常 35 条，29 页 | 58 积分 | 约 ¥1.4（$0.19） |
| 回填一个 X 账号：200 条帖子列表加 20 条全文 | 10 页列表 + 20 次全文 | 40 积分 | 约 ¥0.96（$0.13） |
| 每天盯 1 个 X 账号，一个月最多 | 每次 9 积分 × 31 天 | 279 积分 | 约 ¥6.7（$0.93） |
按 $10 档算，买得越多单价越低。监控只在你开启时运行，随时可以暂停，没有订阅。
也可以不管参数。
直接问。
通过 MCP 接一次 SocialToAI，之后该调哪些接口由 AI 决定，每一步花了多少积分你都看得到。
你问01
这周 X 上，家用咖啡和抹茶哪个更火？
AI 会调用
- search“home coffee”2 积分
- search“matcha”2 积分
合计4 积分
你问02
读一下这条 X 帖子的评论，告诉我大家在抱怨什么。
AI 会调用
- detail你贴的那条帖子1 积分
- comments前 3 页6 积分
合计7 积分
你问03
在 X 上找 5 个发露营咖啡内容的账号，看看他们最近发了什么。
AI 会调用
- search搜账号 · “camping coffee”5 积分
- user_posts5 个账号10 积分
合计15 积分
每个平台，同一种结构。
学一次就够。
X 的帖子和小红书的笔记，返回的字段名一模一样。平台给不了的字段，返回 null。
X详情 · 1 积分
{ "platform": "x", "id": "…", "ref": "…", "approx": [], "type": "content", "url": "https://example.com/…", "format": "video", "title": null, "text": "…", "published_at": "2026-10-08T14:10:00.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": true, "followers": 932620 }, "metrics": { "likes": 155, "comments": 7, "shares": null, "collects": 11, "views": 10638, "reposts": 40 }, "images": [], "hashtags": [], "is_pinned": null}X 给不了，返回 null：
titlemetrics.sharesis_pinned小红书详情 · 12 积分
{ "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-10-09T01:00:34.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": 927, "comments": 122, "shares": 256, "collects": 59, "views": null, "reposts": null }, "images": ["https://example.com/…", "https://example.com/…"], "hashtags": ["…", "…"], "is_pinned": false}小红书给不了，返回 null：
author.verifiedauthor.followersmetrics.viewsmetrics.reposts示例数据字段恒在，变的只是值。
7 个工具能读 X。
全部工具X 有官方 API 吗？
X 提供官方 API，可读取帖子、用户和搜索结果。开发者在 X 开发者控制台注册即可使用，按调用量从预付额度中扣费；用量更大需申请企业方案。
来源：X 官方开发者文档，核对于 2026-10-17。
| 谁能用 | 费用 | 限制 | 来源 | |
|---|---|---|---|---|
| X API（按量付费） | 任何开发者：在 X 开发者控制台注册，买预付额度。 | 每读一条帖子 $0.005，每读一个用户 $0.010，按返回的资源数扣。 | 每个账单周期最多读 300 万条帖子，再多要申请企业方案。X 注明价格可能调整。 | docs.x.com，核对于 2026-10-29 |
| SocialToAI | 有 Key 就能用，不用你的 X 账号，也不用审核。 | 每次 1 积分起（约 $0.0033），失败不扣。 | 只读公开可见的内容；一次调用最多 60 条。 | 价格 |
在这里读 1,000 条帖子：约 50 次 x.search 调用（每页通常 20 条），共 100 积分，按第一档约 $0.33；X 官方按每条 $0.005 算是 $5。 算一下要多少钱
- 各平台评论接口对比哪些平台能取评论、每页多少条、多少积分。
- 各平台字幕接口对比哪些平台能取字幕、带不带时间。
- X 官方 API 太贵时，怎么让 AI 读 XX 官方价格（带来源），以及改为按次读 X
- 视频评论分析：让 AI 读完评论，带上原话评论在说什么，带原话：用工具还是让 AI 读，各平台价格，一次录制
- 批量查几百条链接的互动数据一次查几百条链接的数字：各平台价格、赠送积分能跑多少、什么时候会停
- 怎么按日期搜 X：since 和 untilsince 和 until 的两种写法，附实测，以及读一个月要多少钱
- 每天盯 X（Twitter）：一个月到底花多少每天盯 X 的关键词或账号，每次 2 积分，和 X 官方价格对比的月成本
- 每天盯竞品账号：发了什么，哪条比平时好每天盯竞品账号：新发了什么、哪条比平时好，每个账号 9 积分起
- 每天盯品牌口碑：新讨论和背后的原帖每天盯品牌口碑：态度占比和背后的原帖，每次 16 积分起
- X 今日热榜每天更新的榜单，一页看全。
- X MCP 服务器让你的 AI 直接读 X。