API 文档

面向公开 X 数据的 REST API：用户资料、推文、搜索、粉丝、列表和趋势。每个端点都是 GET，返回 JSON，并按下面标出的固定 token 数计费。新账户在确认邮箱后获得 1,000 个 token。

在用 AI 代理开发？MCP 服务器和技能可以把 Claude、Cursor 和 VS Code 接到同一批端点上。

快速开始

创建账户并确认邮箱。
在 API key 页面创建密钥。它只显示一次，请把它存到安全的地方。
把它放在x-api-key请求头里：

请求

curl "https://api.xscraper.online/api/v1/twitter/users/profile_by_username/jack" \
  -H "x-api-key: $XSCRAPER_KEY"

身份验证

每个请求都需要x-api-key: <your key>。密钥以xs_开头。每个账户只有一把密钥；轮换后会签发新密钥，并立刻停用旧密钥。把密钥留在你的服务器上。不要把它放进浏览器或移动应用的代码里。

Token 与价格

每次调用按该端点的价格计费。接受count的端点按基础价加每页结果的价格收费，所以要得越多越贵。只有调用成功才扣费：任何错误响应都会退回，但 404（未找到）是真实结果，仍会扣费。每个响应都会报告x-tokens-cost和x-tokens-remaining。

端点	路径	最低	最高
推文
用户推文/users/tweets/:username	/users/tweets/:username	3	7
最新一条推文/users/latest_tweet/:username	/users/latest_tweet/:username	1	1
用户推文和回复/users/replies/:username	/users/replies/:username	3	7
按用户 ID 获取推文/users/tweets_by_user_id/:userId	/users/tweets_by_user_id/:userId	3	7
按用户 ID 获取推文和回复/users/replies_by_user_id/:userId	/users/replies_by_user_id/:userId	3	7
点赞的推文/users/likes/:username	/users/likes/:username	4	8
按 ID 获取推文/tweets/:tweetId	/tweets/:tweetId	1	1
推文的回复/tweets/:tweetId/replies	/tweets/:tweetId/replies	4	4
引用转推/tweets/:tweetId/quotes	/tweets/:tweetId/quotes	4	4
搜索
搜索用户/users/search_profiles	/users/search_profiles	4	6
搜索推文/tweets/search	/tweets/search	6	14
高级搜索/tweets/advanced_search	/tweets/advanced_search	8	12
用户资料
按用户名获取资料/users/profile_by_username/:username	/users/profile_by_username/:username	1	1
按用户 ID 获取资料/users/profile_by_userid/:userId	/users/profile_by_userid/:userId	3	3
用户名转用户 ID/users/user_id/:username	/users/user_id/:username	1	1
社交关系
粉丝/users/followers/:userId	/users/followers/:userId	4	4
正在关注/users/following/:userId	/users/following/:userId	4	4
列表
列表推文/lists/:listId/tweets	/lists/:listId/tweets	3	7
趋势
趋势/trends	/trends	2	2
账户
Token 余额/balance	/balance	0	0

响应

每个响应，无论成功还是出错，都使用同一个信封。数据在 data 里。

成功

{
  "success": true,
  "message": "Profile for @jack",
  "data": {
    "userId": "12",
    "username": "jack"
  },
  "errors": null
}

错误（402）

{
  "success": false,
  "message": "Not enough tokens: this call costs 14 and your balance is 10.",
  "data": null,
  "errors": [
    {
      "field": "balance",
      "message": "insufficient_tokens"
    }
  ]
}

错误

状态	含义
400	缺少参数或参数无效。消息里会说明是哪一个。
401	缺少、未知或已吊销的 x-api-key。
402	余额低于这次调用的价格。没有扣费。
403	这个端点需要管理员密钥。
404	用户或列表不存在，或不可见（找不到推文时返回 data: null）。已扣费：查询已经执行。
429	你的账户每分钟请求过多，或同时请求过多。等待 Retry-After 给出的秒数。
503	抓取池正忙。按 Retry-After 头之后再试。
5xx	上游失败。可以重试。

速率限制

每把密钥每分钟可以发出 100 次请求。响应带有X-RateLimit-Limit和X-RateLimit-Remaining；429 还会带有Retry-After。被限速的调用不扣费。

全部端点

同一份列表也可以作为 OpenAPI 3.1 规范获取，地址是/openapi.json，以及给 AI 代理看的纯文本摘要，地址是/llms.txt。