社群资料、帖子、成员
X 的社群（Communities）：社群资料、社群里的帖子和成员。
GET /v1/x/communities/posts/list$0.00033 个接口 · $0.0003 起 →X（推特）API
也叫X (Twitter)
21 个接口读 X（推特）：帖子、用户、对话串、热榜、X 社群、X 列表。一次 $0.0003 起。不用登录 X，不用 Cookie；失败不收费。
接口21 个接口分 6 组，同一种返回格式
价格$0.0003 起约 ¥0.002一次。失败不收费
近 30 天可用100% 在线 · 接口在接调用的时间占比
数据当场取榜单是 5 分钟一次的快照
调一次，拿回来的样子
录下来的真实返回，字段已经整理好，直接给 AI 或表格用。GET/v1/x/posts/search$0.0020
字段值
typevideo
langen
published_at2026-10-12 00:44 UTC
author.verifiedtrue
author.followers7,425
metrics.likes238
metrics.comments37
metrics.favorites145
2026-10-12 19:10 UTC 录下的真实返回，这里是前 8 行。
在 Playground 里跑一次 · $0.0020录制的返回
{
"code": "ok",
"request_id": "f56e2410-206b-4506-a850-44cf2be4613e",
"data": {
"items": [
{
"id": "1860387339653354774",
"url": "https://x.com/i/status/1860387339653354774",
"type": "video",
"text": "My honest take on weather forecast, a month in.",
"lang": "en",
"published_at": "2026-10-12T00:44:12.000Z",
"author": {
"id": "118815899823132376",
"username": "trail_and_lens",
"name": "Maya Chen",
"avatar_url": "https://pbs.twimg.com/profile_images/1838837416644987075/31t9r3Fm_normal.jpg",
"verified": true,
"followers": 7425
},
"metrics": {
"likes": 238,
"comments": 37,
"favorites": 145,
"views": 8357,
"reposts": 121
},
"images": [],
"hashtags": [],
"mentions": [
{
"id": "124366312906800227",
"username": "fieldnotes_studio",
"name": "Field Notes Studio"
}
],
"post_id": null,
"parent_id": null
},
// … 另有 19 条
]
},
"page": {
"next_cursor": "c1.0BcduLiC6vViwQfDR_nS6Twlb6kjko4Qpbx3fUDt",
"cursor_expires_at": "2026-10-12T20:10:39.000Z",
"has_more": true,
"returned": 20
},
"warnings": [],
"meta": {
"capability": "x.posts.search",
"result_status": "complete",
"fetched_at": "2026-10-12T19:10:39.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"title": "platform",
"metrics.shares": "platform",
"is_pinned": "capability",
"root_id": "platform"
},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 19:10 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。
能拿到什么
每一行是一个接口：返回什么，一次多少钱。
只有 X 有的数据
X 社群、X 列表：原本要登录 X 自己的后台才看得到的数据，在这里各是一次 GET。
X 社群 API →
X 列表 API →
列表帖子、成员、关注者
X 的列表（Lists）：列表里的帖子、成员和关注者。
GET /v1/x/lists/posts/list$0.00203 个接口 · $0.0004 起 →X（推特）趋势：美国热门话题 →GET /v1/x/trends/list$0.0090
现在 X 在看什么
调用那一刻平台自己的榜单，带热度值。免费榜单页上有完整的一份。
前 5 条 · 读取于 2026 年 11 月 2 日 11:05 UTC真实返回
1 Good Monday
2 Tucker
3 Grambling
4 Peace Coin
5 Isaiah Miranda
大家拿它做什么
你的 AI 现在就能用 X 数据跑的现成任务。每个任务是几次调用，带花费上限。
https://api.dataxapi.com/mcp三步开始
这里演示的是 X 帖子搜索。X 的其他接口都是同样的调法，返回同样的格式。
拿一把 Key
用邮箱验证码或 Google 登录。可免费试用，不用绑卡。
自己调，或者让你的 AI 调
代码里一次 GET。或者把下面这段话带着你的 Key 贴给你的 agent：它自己接好，然后能自己找到并调用这些接口。
读 https://dataxapi.com/agents.md，在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_live_…，之后所有 DataXAPI 的调用都用它。
每次读到的都是同一种格式
数据在 data.items（单个对象在 data.item），下一页在 page.next_cursor，扣了多少在 meta.billing.amount。失败不扣费。
curl -G "https://api.dataxapi.com/v1/x/posts/search" \ --data-urlencode "query=weather forecast" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
# pip install dataxapi from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.x.posts.search(query="weather forecast") print(result["data"]["items"])
// npm i @dataxapi/sdk import { DataXAPI } from "@dataxapi/sdk"; const dx = new DataXAPI(); // reads DATAXAPI_API_KEY const result = await dx.x.posts.search({ query: "weather forecast" }); console.log(result.data.items);
dataxapi call x.posts.search 'query=weather forecast'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端，然后让你的 AI 调用 x.posts.search。
边界情况
X 这些接口在边界上怎么表现，以及调用结果不对时先看哪里。
- 每页条数
- 列表每页 20 到 200 条，各接口不同。16 个列表里有 14 个能翻页：把
page.next_cursor作为cursor传回，每一页是一次单独的调用。其余只有一页。 - 给不了的字段
- 21 个接口里有 16 个填不满它返回的对象。每个接口的页面列出了给不了哪些，每次返回也在
meta.unavailable里再写一遍：缺的字段不会被悄悄写成 0。 - 对象不存在时读起来像空结果
- X 社群帖子、X 列表帖子、X 帖子引用列表、X 帖子回复列表、X 帖子转推用户、X 帖子对话串、X 用户粉丝列表、X 用户关注列表、X 用户提及、X 用户帖子列表、X 社群成员、X 列表关注者、X 列表成员：对象不存在和对象下面没有东西分不出来，所以返回空结果而不是 404，并按空结果计费。
- 一次取多个
- 用
ids一次请求可以取多个：X 用户资料（最多 100 个）。 - 预览结构
- 有 1 个接口返回的是预览结构，字段还可能调整；其余返回统一的结构，所有平台都一样。
- 快照
- X 趋势榜：榜单是每 5 分钟刷新一次的快照，
meta.fetched_at写明是什么时候取的。 - 账号名还是编号
- 粉丝、关注、提及和用户帖子用
username，就是不带 @ 的账号名；用户资料可以用账号名、编号，或者一次最多 100 个ids。 - 账号或帖子不存在时
- 粉丝、关注、提及、引用、转推这几个，对象不存在时返回空列表，按空结果计费。用户帖子、帖子回复、列表帖子则返回
upstream_failed，不扣费，可以再试一次。 - 几个数各是什么
metrics.comments是回复数，metrics.favorites是书签数，metrics.reposts是转推数；引用另算，在ext.quotes。- 列表关注者只有一页
x.lists.followers.list最多返回 20 个账号，没有下一页。- 视频转文字限两分钟
- 超过两分钟的视频按参数不合法拒绝；没人说话的视频、没有视频的帖子、不存在的帖子，都按不存在返回。两种都不扣费。
关于 X（推特）API 的常见问题
回答从简，细节在各接口的页面。
X（推特）API 怎么收费？
按次收费，没有订阅。一次 $0.0003 到 $0.0400，每个接口的页面写明自己的价格。有 11 个接口按返回的条数计费，每次有最低和最高。拿到数据才扣费，失败不收。
需要 X 账号或 Cookie 吗？
不需要。你只拿一把 DataXAPI 的 Key：不用登录 X，不用 Cookie，也不用养设备。接口只返回公开可见的数据。
数据是实时的吗？
每次调用都当场去 X 取，meta.fetched_at 写明取到的时间。X 趋势榜：榜单是每 5 分钟刷新一次的快照。结果保留 24 小时，带同一个 Idempotency-Key 重试不会再扣一次。
空结果收费吗？
16 个接口里有 15 个在列表返回空结果时照价收费：搜索已经执行了。读单个对象而对象不存在时返回 not_found，收不收费看接口页。
X 改版了怎么办？
调用失败不管什么原因都不扣费。被暂停的接口返回 capability_paused，同样不扣费；GET /v1/catalog/status 写着现在哪些能用。
相关
用这些接口做的工具
一把 Key 调 X。
免费试用：按 $0.0003 一次，最多可调 333 次，不用绑卡。 不用登录 X，不用 Cookie，没有订阅。失败不收费。