X 列表 API(推特列表)

也叫X Lists

3 个接口读 X 列表:列表帖子、成员、关注者。一次 $0.0004 到 $0.0080。不用登录 X,不用 Cookie;失败不收费。

在 Playground 里跑一次在你的 AI 里用它登录后运行。可免费试用,不用绑卡。
接口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 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。

X 列表帖子 API · 这份示例的 JSON 文件

这 3 个接口

每一行是一个接口:返回什么,一次多少钱。

接口路径返回价格
X 列表成员GET/v1/x/lists/members/list账号列表$0.0004 / 条
X 列表关注者GET/v1/x/lists/followers/list账号列表$0.0004 / 条
X 列表帖子GET/v1/x/lists/posts/list内容列表$0.0020
价格是现行价格。失败和结果不确定的调用不收费。看实时状态 →

一个典型用法,和它的账单

每天读一个精选列表。每天一次调用,最多拿到列表里的 100 条帖子;成员读一次。成员按返回的条数计费,所以那一行是最多会花的数。

调用次数花费
X 列表帖子7 × $0.0020$0.0140
X 列表成员1 × $0.0080$0.0080
合计 8 次调用最多$0.0220

在你的 AI 里用它

接一次,你的 AI 就能自己找到这些接口、看价格、调用。

直接对它说任何已接入的 AI
用 DataXAPI 读这个 X 列表今天的帖子,给我互动最多的 5 条。
还没接入?把这段话贴给你的 agent
读 https://dataxapi.com/agents.md,在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_live_…,之后所有 DataXAPI 的调用都用它。
登录后复制,带上你的 Key
带着这页去问会把 Markdown 版带过去

关于 X 列表数据的常见问题

回答从简,细节在各接口的页面。

X 列表帖子 API →
多少钱?

按次收费,没有订阅。一次 $0.0004 到 $0.0080,每个接口的页面写明自己的价格。有 2 个接口按返回的条数计费,每次有最低和最高。拿到数据才扣费,失败不收。

能读到一个列表的全部关注者吗?

不能,只有前 20 个。实测时平台给的下一页是空的,所以不提供下一页。列表成员可以正常往后翻。

列表不存在会怎样?

时间线不会返回 404:来源只说请求失败,所以按来源出错返回,可以重试一次,不收费。成员和关注者列表返回空结果,按空结果计费。

需要 X 列表或 X 的账号吗?

不需要。你只拿一把 DataXAPI 的 Key:不用登录 X,不用 Cookie,也不用广告主账号。

别处的同类数据

同一把 Key、同一种返回格式也能读这些。

X 的全部 21 个接口 →

其他有自己名字的数据

一把 Key 读 X 列表。

不用登录平台,不用 Cookie,没有订阅。失败不收费。

免费开始