X 列表 API(推特列表)
也叫X Lists
3 个接口读 X 列表:列表帖子、成员、关注者。一次 $0.0004 到 $0.0080。不用登录 X,不用 Cookie;失败不收费。
接口3 个接口列表帖子、成员、关注者
价格$0.0004 起一次。失败不收费
数据源出错时自动重试同一条线路再试,有备用线路就切过去;不收费
更新当场取调用那一刻去取
能拿到什么
2026-10-12 19:10 UTC 录下的真实返回,这里是前 8 行。 X 列表帖子 API →
字段值
typeimage
langen
published_at2026-10-12 18:44 UTC
author.verifiedtrue
author.followers13,831,881
metrics.likes10
metrics.comments1
metrics.favorites0
这组数据是什么
X 列表(Lists)是有人把一批账号收在一个名字下,列表的时间线就是这些账号发的帖子。这组接口按列表编号读时间线(从新到旧,每页约 100 条)、列表收录的账号和关注这个列表的账号。
帖子按内容对象返回,账号按账号对象返回,和 X 其他接口一样。别人维护好的列表就是现成的关注名单:一次调用就读到里面所有账号发的帖子。
- 时间线
- 从新到旧,每页约 100 条,一次调用一个价,不论返回多少条;用
page.next_cursor往前翻更早的帖子。 - 成员和关注者
- 成员是列表收录的账号,每页 20 个。关注者是关注了这个列表的账号:最多 20 个,只有一页。
- 列表编号
- 一串数字。这里没有搜列表的接口,要从已知的列表开始。
一段录制的返回
{
"code": "ok",
"request_id": "daed437e-51c7-4e80-81ae-f472966a645e",
"data": {
"items": [
{
"id": "1831534145281940202",
"url": "https://x.com/i/status/1831534145281940202",
"type": "image",
"text": "Everything I wish I knew about weekend hiking before starting.",
"lang": "en",
"published_at": "2026-10-12T18:44:16.000Z",
"author": {
"id": "157495204601603788",
"username": "trail_and_lens",
"name": "Maya Chen",
"avatar_url": "https://pbs.twimg.com/profile_images/1854414097030772792/c2r-3Ey9_normal.jpg",
"verified": true,
"followers": 13831881
},
"metrics": {
"likes": 10,
"comments": 1,
"favorites": 0,
"views": 5423,
"reposts": 2
},
"images": ["https://pbs.twimg.com/media/mc57zZyDUd0T1UG.jpg"]
},
// … 另有 98 条
]
},
"page": {
"next_cursor": "c1.DaMJvJG5_Ub_HuXC4ZuF6v_vzTXNuBrdCGKlYyyB",
"cursor_expires_at": "2026-10-12T20:10:56.000Z",
"has_more": true,
"returned": 99
},
"warnings": [],
"meta": {
"capability": "x.lists.posts.list",
"result_status": "complete",
"fetched_at": "2026-10-12T19:10:56.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"title": "platform",
"metrics.shares": "platform",
"is_pinned": "capability",
"root_id": "platform",
"hashtags": "capability",
"mentions": "capability",
"post_id": "capability",
"parent_id": "capability"
},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 19:10 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。
这 3 个接口
每一行是一个接口:返回什么,一次多少钱。
在你的 AI 里用它
接一次,你的 AI 就能自己找到这些接口、看价格、调用。
直接对它说任何已接入的 AI
用 DataXAPI 读这个 X 列表今天的帖子,给我互动最多的 5 条。
还没接入?把这段话贴给你的 agent登录后复制,带上你的 Key
读 https://dataxapi.com/agents.md,在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_live_…,之后所有 DataXAPI 的调用都用它。带着这页去问会把 Markdown 版带过去
多少钱?
按次收费,没有订阅。一次 $0.0004 到 $0.0080,每个接口的页面写明自己的价格。有 2 个接口按返回的条数计费,每次有最低和最高。拿到数据才扣费,失败不收。
能读到一个列表的全部关注者吗?
不能,只有前 20 个。实测时平台给的下一页是空的,所以不提供下一页。列表成员可以正常往后翻。
列表不存在会怎样?
时间线不会返回 404:来源只说请求失败,所以按来源出错返回,可以重试一次,不收费。成员和关注者列表返回空结果,按空结果计费。
需要 X 列表或 X 的账号吗?
不需要。你只拿一把 DataXAPI 的 Key:不用登录 X,不用 Cookie,也不用广告主账号。
别处的同类数据
同一把 Key、同一种返回格式也能读这些。
其他有自己名字的数据
一把 Key 读 X 列表。
不用登录平台,不用 Cookie,没有订阅。失败不收费。