推特创作者的蓝朋友 · 互粉互关 / 流量趋势 / 创作者收益了解创作者计划
🔥 HOT推特 API · X 数据接口 · MCP

X(推特)数据 API,用积分按量付费

用户资料、推文、粉丝、搜索、热门趋势,一套简单的 REST API 全部搞定。创建 Key,任何语言都能调用,按返回结果用蓝朋友积分付费——不用订阅,没有最低消费。

接口地址https://xbluev.com/api/v1
与 X 官方 API 对比
X 官方 API蓝朋友 API
1,000 条推文$5.00$0.378便宜 13 倍
1,000 个用户资料$10.00$0.553便宜 18 倍
1,000 个粉丝资料(批量)$10.00$0.075便宜 135 倍
开通方式开发者账号 + 审核注册后创建 Key 即可使用
月费 / 最低消费预充值,按读取量扣费无 · 每次请求 0.05 积分起
网络—⚡ 全球 CDN 加速接入
官方价格:X API 按量计费,读取推文 $0.005 / 条、读取用户 $0.010 / 个(docs.x.com,2026 年)。我们的美元价格按月度会员折算($5.9 = 1,600 积分,约 $0.0037 / 积分),并按典型分页估算。 docs.x.com ↗
按结果计费每次请求 0.05 积分起
一个 Key 一个请求头X-API-Key 鉴权
REST + JSON任何语言都能调用
每分钟 60 次按 Key 限流,返回限流头

一键把 X 数据接入你的 AI

让 Cursor、Claude、VS Code、Codex 等 AI 直接查询实时推特数据。选 Key → 选客户端 → 一键安装。

16 个只读工具Streamable HTTP与 REST 同一套积分和限流
1

选择 API Key

选中的 Key 会自动填进下面所有配置。

登录后获取你的 Key
2

选择你的 AI 客户端

3

安装

配置文件~/.cursor/mcp.json(全局)或项目内 .cursor/mcp.json

  1. 点击「一键添加到 Cursor」,在弹出的 Cursor 窗口里确认安装。
  2. 或把下面的配置合并进 mcp.json。
  3. 在 Settings → MCP 中确认 xbluev 显示为绿色。
4

测试并开始使用

接入后可以这样问 AI
🔒 Key 属于密钥:只保存在客户端配置里,不要发到聊天或提交到公开仓库。一键安装链接只会把 Key 交给你本机的应用。 给 AI 阅读的完整文档(Markdown) ↗下载 XBlueV Skill 安装包(.zip)https://xbluev.com/api/mcp

快速开始

  1. 1

    登录后在下方创建一个 API Key。

  2. 2

    每次请求都在 X-API-Key 请求头里带上它。

  3. 3

    每次响应都会在 X-Points-Cost 响应头里告诉你本次花了多少积分。

curl "https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk" \
  -H "X-API-Key: xbv_your_key_here"

我的 API Key

Key 默认隐藏显示,点「复制」即可拿到完整 Key。每人最多 5 个有效 Key。

认证

每次请求都必须在 X-API-Key 请求头里带上你的 Key。请妥善保管——拿到 Key 的人可以消耗你的积分。如果泄露,请立即作废并重新创建。

X-API-Key: xbv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应头

X-Points-Cost本次请求消耗的积分
X-Points-Balance本次请求后的积分余额
X-Result-Count本次计费的结果条数
X-RateLimit-Remaining本分钟剩余请求次数

计费

每次请求收取少量基础费,再按返回的结果条数计费。上游失败的请求不收费。小数积分会累计,满 1 积分扣 1 积分。

计费项积分
每次请求(最低消费,0 条结果也收取)0.05
每条推文 / 用户 / 搜索结果0.1
每条粉丝 / 关注资料0.02
每个粉丝 ID0.005
请求返回条数积分
推文搜索00.05
推文搜索10.15
推文搜索50.55
推文搜索202.05
粉丝列表(pageSize=200)2004.05
粉丝 ID5,00025.05

所有套餐都从积分余额中扣除,会员只是积分更多:月度会员每月 1,600 积分,年度会员开通即发全年 27,000 积分。

错误码

HTTPcode说明
400missing_parameter缺少必填参数。
401missing_api_key / invalid_api_key没有带 Key,或 Key 错误 / 已作废。
402insufficient_points积分余额不足。
404unknown_endpoint请求的路径不是可用接口。
429rate_limited超过每分钟 60 次,见 Retry-After。
502 / 504upstream_error / upstream_timeout数据源出错,本次不收费。

错误响应统一是这个格式:

{
  "error": {
    "code": "insufficient_points",
    "message": "Not enough points. Top up at https://xbluev.com/en/pricing"
  }
}

常见问题

可以免费试用吗?

可以。新账号每天都能免费领取积分,一次请求最低只要 0.05 积分,足够做几十次测试。每个接口下方都有「在线调试」,不用写代码就能试。

有隐藏收费吗?

没有。你付的就是响应头 X-Points-Cost 里显示的金额:少量基础费 + 按结果条数计费。没有月费、没有最低消费,上游失败的请求不收费。

如何使用?

在「API Key」里创建一个 Key,然后对 https://xbluev.com/api/v1/… 发 GET 请求,并在 X-API-Key 请求头里带上它。下面每个接口都有 cURL、JavaScript、Python 示例。

数据是最新的吗?

是的。每次请求都会在你调用的那一刻实时从 X 获取,不会返回旧缓存。

积分用完了会怎样?

请求会返回 402 insufficient_points,充值或每日领取积分后即可继续使用。

有调用频率限制吗?

每个 Key 每分钟 60 次。可以看响应头 X-RateLimit-Remaining;超出后返回 429,并带 Retry-After。

Key 泄露了怎么办?

立即在「API Key」里删除它并重新创建,删除后立刻失效。

可以在浏览器里直接调用吗?

可以,已开启跨域(CORS)。但不要把 Key 写进公开的前端代码,建议从你的服务端调用。

接口列表

GET/twitter/user/info费用: 0.05 每次请求 · 结果 0.1

获取用户资料

按用户名获取账号资料:粉丝数、关注数、简介、蓝 V 状态、头像等。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)

请求示例

curl "https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "status": "success",
  "data": {
    "id": "44196397",
    "userName": "elonmusk",
    "name": "Elon Musk",
    "followers": 203000000,
    "following": 1100,
    "isBlueVerified": true,
    "profilePicture": "https://pbs.twimg.com/profile_images/…_normal.jpg",
    "description": "…"
  }
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/batch_info_by_ids费用: 0.05 每次请求 · +0.1 / 条

批量获取用户资料

按用户 ID 批量获取资料,ID 之间用英文逗号分隔。

参数

参数类型必填说明
userIdsstring是用户 ID,逗号分隔

请求示例

curl "https://xbluev.com/api/v1/twitter/user/batch_info_by_ids?userIds=44196397%2C783214" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "status": "success",
  "users": [
    {
      "id": "44196397",
      "userName": "elonmusk",
      "name": "Elon Musk",
      "followers": 203000000,
      "following": 1100,
      "isBlueVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/…_normal.jpg",
      "description": "…"
    }
  ]
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/last_tweets费用: 0.05 每次请求 · +0.1 / 条

用户最新推文

按时间倒序返回用户最新的推文,每页约 20 条。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)
includeRepliesboolean否是否包含回复 · 默认: false
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/user/last_tweets?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "status": "success",
  "data": {
    "tweets": [
      {
        "id": "1846987139428634858",
        "url": "https://x.com/elonmusk/status/1846987139428634858",
        "text": "…",
        "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
        "likeCount": 31024,
        "retweetCount": 4120,
        "replyCount": 2981,
        "viewCount": 9821340,
        "lang": "en",
        "isReply": false,
        "author": {
          "userName": "elonmusk",
          "name": "Elon Musk",
          "id": "44196397"
        }
      }
    ]
  },
  "has_next_page": true,
  "next_cursor": "DAABCgAB…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/mentions费用: 0.05 每次请求 · +0.1 / 条

提及该用户的推文

返回 @ 了该用户的推文。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/user/mentions?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "tweets": [
    {
      "id": "1846987139428634858",
      "url": "https://x.com/elonmusk/status/1846987139428634858",
      "text": "…",
      "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
      "likeCount": 31024,
      "retweetCount": 4120,
      "replyCount": 2981,
      "viewCount": 9821340,
      "lang": "en",
      "isReply": false,
      "author": {
        "userName": "elonmusk",
        "name": "Elon Musk",
        "id": "44196397"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/followers费用: 0.05 每次请求 · +0.02 / 条资料

粉丝列表

返回用户的粉丝资料列表,pageSize 最大 200,按条数计费(批量更便宜)。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)
pageSizeinteger否每页条数,20–200 · 默认: 200
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/user/followers?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "followers": [
    {
      "id": "44196397",
      "userName": "elonmusk",
      "name": "Elon Musk",
      "followers": 203000000,
      "following": 1100,
      "isBlueVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/…_normal.jpg",
      "description": "…"
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/followings费用: 0.05 每次请求 · +0.02 / 条资料

关注列表

返回用户关注的账号资料列表,pageSize 最大 200。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)
pageSizeinteger否每页条数,20–200 · 默认: 200
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/user/followings?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "followings": [
    {
      "id": "44196397",
      "userName": "elonmusk",
      "name": "Elon Musk",
      "followers": 203000000,
      "following": 1100,
      "isBlueVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/…_normal.jpg",
      "description": "…"
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/followers_ids费用: 0.05 每次请求 · +0.005 / ID

粉丝 ID 列表

只返回粉丝的用户 ID,单页最多 5000 个,适合大号批量分析。

参数

参数类型必填说明
userNamestring是推特用户名(不带 @)
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/user/followers_ids?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "ids": [
    "783214",
    "12",
    "…"
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/user/check_follow_relationship费用: 0.05 每次请求 · 结果 0.1

检查关注关系

检查 A 是否关注了 B、B 是否关注了 A。

参数

参数类型必填说明
source_user_namestring是用户 A
target_user_namestring是用户 B

请求示例

curl "https://xbluev.com/api/v1/twitter/user/check_follow_relationship?source_user_name=xbluev&target_user_name=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "status": "success",
  "data": {
    "following": true,
    "followed_by": false
  }
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/tweets费用: 0.05 每次请求 · +0.1 / 条

按 ID 获取推文

按推文 ID 获取推文详情和互动数据,多个 ID 用逗号分隔。

参数

参数类型必填说明
tweet_idsstring是推文 ID,逗号分隔

请求示例

curl "https://xbluev.com/api/v1/twitter/tweets?tweet_ids=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "status": "success",
  "tweets": [
    {
      "id": "1846987139428634858",
      "url": "https://x.com/elonmusk/status/1846987139428634858",
      "text": "…",
      "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
      "likeCount": 31024,
      "retweetCount": 4120,
      "replyCount": 2981,
      "viewCount": 9821340,
      "lang": "en",
      "isReply": false,
      "author": {
        "userName": "elonmusk",
        "name": "Elon Musk",
        "id": "44196397"
      }
    }
  ]
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/tweet/replies费用: 0.05 每次请求 · +0.1 / 条

推文回复

返回某条推文下的回复。

参数

参数类型必填说明
tweetIdstring是推文 ID
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/tweet/replies?tweetId=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "tweets": [
    {
      "id": "1846987139428634858",
      "url": "https://x.com/elonmusk/status/1846987139428634858",
      "text": "…",
      "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
      "likeCount": 31024,
      "retweetCount": 4120,
      "replyCount": 2981,
      "viewCount": 9821340,
      "lang": "en",
      "isReply": false,
      "author": {
        "userName": "elonmusk",
        "name": "Elon Musk",
        "id": "44196397"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/tweet/quotes费用: 0.05 每次请求 · +0.1 / 条

推文引用

返回引用了某条推文的推文。

参数

参数类型必填说明
tweetIdstring是推文 ID
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/tweet/quotes?tweetId=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "tweets": [
    {
      "id": "1846987139428634858",
      "url": "https://x.com/elonmusk/status/1846987139428634858",
      "text": "…",
      "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
      "likeCount": 31024,
      "retweetCount": 4120,
      "replyCount": 2981,
      "viewCount": 9821340,
      "lang": "en",
      "isReply": false,
      "author": {
        "userName": "elonmusk",
        "name": "Elon Musk",
        "id": "44196397"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/tweet/retweeters费用: 0.05 每次请求 · +0.1 / 条

转发者

返回转发了某条推文的用户。

参数

参数类型必填说明
tweetIdstring是推文 ID
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/tweet/retweeters?tweetId=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "users": [
    {
      "id": "44196397",
      "userName": "elonmusk",
      "name": "Elon Musk",
      "followers": 203000000,
      "following": 1100,
      "isBlueVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/…_normal.jpg",
      "description": "…"
    }
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

在线调试

Key 只保存在当前浏览器标签页。
GET/twitter/tweet/thread_context费用: 0.05 每次请求 · +0.1 / 条

推文串上下文

返回推文所在的整串对话。

参数

参数类型必填说明
tweetIdstring是推文 ID
cursorstring否分页游标,首次请求留空,之后传上一页返回的 next_cursor

请求示例

curl "https://xbluev.com/api/v1/twitter/tweet/thread_context?tweetId=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
返回示例
{
  "tweets": [
    {
      "id": "1846987139428634858",
      "url": "https://x.com/elonmusk/status/1846987139428634858",
      "text": "…",
      "createdAt": "Fri Oct 18 17:39:13 +0000 2024",
      "likeCount": 31024,
      "retweetCount": 4120,
      "replyCount": 2981,
      "viewCount": 9821340,
      "lang": "en",
      "isReply": false,
      "author": {
        "userName": "elonmusk",
        "name": "Elon Musk",
        "id": "44196397"
      }
    }
  ],
  "has_next_page": false,
  "next_cursor": null
}

在线调试

Key 只保存在当前浏览器标签页。

相关工具与指南