X(推特)数据 API,用积分按量付费
用户资料、推文、粉丝、搜索、热门趋势,一套简单的 REST API 全部搞定。创建 Key,任何语言都能调用,按返回结果用蓝朋友积分付费——不用订阅,没有最低消费。
https://xbluev.com/api/v1| 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 数据接入你的 AI
让 Cursor、Claude、VS Code、Codex 等 AI 直接查询实时推特数据。选 Key → 选客户端 → 一键安装。
选择你的 AI 客户端
安装
配置文件~/.cursor/mcp.json(全局)或项目内 .cursor/mcp.json
- 点击「一键添加到 Cursor」,在弹出的 Cursor 窗口里确认安装。
- 或把下面的配置合并进 mcp.json。
- 在 Settings → MCP 中确认 xbluev 显示为绿色。
配置文件项目内 .vscode/mcp.json
- 点击「一键安装到 VS Code」,在 VS Code 里确认安装。
- 或把下面的配置保存为 .vscode/mcp.json。
- 在 Copilot Chat 的 Agent 模式里打开工具列表,勾选 xbluev。
配置文件macOS:~/Library/Application Support/Claude/claude_desktop_config.json;Windows:%APPDATA%\Claude\claude_desktop_config.json
- 需要先安装 Node.js 18+。
- Claude Desktop → 设置 → 开发者 → 编辑配置,把下面的内容合并进去。
- 完全退出并重新打开 Claude Desktop,输入框旁的工具图标里会出现 xbluev。
配置文件~/.codeium/windsurf/mcp_config.json
- Windsurf → Settings → Cascade → MCP Servers → View raw config。
- 合并下面的配置并保存,点击 Refresh。
配置文件~/.codex/config.toml
在启动 Codex 的终端里设置 Key(PowerShell 用 $env:XBLUEV_API_KEY="…")
- 把下面的配置追加到 config.toml。
- 设置环境变量 XBLUEV_API_KEY 后重新启动 Codex。
- 在 Codex 里输入 /mcp 查看 xbluev。
配置文件Cline → MCP Servers → Configure → cline_mcp_settings.json
- 在 Cline 面板点 MCP Servers → Configure MCP Servers。
- 合并下面的配置并保存,Cline 会自动连接。
配置文件任何支持 Streamable HTTP 的 MCP 客户端
- 传输方式选 Streamable HTTP(不是 SSE),地址填下面的 url。
- 请求头加 X-API-Key,或 Authorization: Bearer <你的 Key>。
测试并开始使用
https://xbluev.com/api/mcp 快速开始
- 1
登录后在下方创建一个 API Key。
- 2
每次请求都在 X-API-Key 请求头里带上它。
- 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 |
| 每个粉丝 ID | 0.005 |
| 请求 | 返回条数 | 积分 |
|---|---|---|
| 推文搜索 | 0 | 0.05 |
| 推文搜索 | 1 | 0.15 |
| 推文搜索 | 5 | 0.55 |
| 推文搜索 | 20 | 2.05 |
| 粉丝列表(pageSize=200) | 200 | 4.05 |
| 粉丝 ID | 5,000 | 25.05 |
所有套餐都从积分余额中扣除,会员只是积分更多:月度会员每月 1,600 积分,年度会员开通即发全年 27,000 积分。
错误码
| HTTP | code | 说明 |
|---|---|---|
| 400 | missing_parameter | 缺少必填参数。 |
| 401 | missing_api_key / invalid_api_key | 没有带 Key,或 Key 错误 / 已作废。 |
| 402 | insufficient_points | 积分余额不足。 |
| 404 | unknown_endpoint | 请求的路径不是可用接口。 |
| 429 | rate_limited | 超过每分钟 60 次,见 Retry-After。 |
| 502 / 504 | upstream_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 写进公开的前端代码,建议从你的服务端调用。
接口列表
/twitter/user/info费用: 0.05 每次请求 · 结果 0.1获取用户资料
按用户名获取账号资料:粉丝数、关注数、简介、蓝 V 状态、头像等。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/info",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}
}/twitter/user/batch_info_by_ids费用: 0.05 每次请求 · +0.1 / 条批量获取用户资料
按用户 ID 批量获取资料,ID 之间用英文逗号分隔。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userIds | string | 是 | 用户 ID,逗号分隔 |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/batch_info_by_ids?userIds=44196397%2C783214" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/batch_info_by_ids?userIds=44196397%2C783214", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/batch_info_by_ids",
params={"userIds": "44196397,783214"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}
]
}/twitter/user/last_tweets费用: 0.05 每次请求 · +0.1 / 条用户最新推文
按时间倒序返回用户最新的推文,每页约 20 条。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
includeReplies | boolean | 否 | 是否包含回复 · 默认: false |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/last_tweets?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/last_tweets?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/last_tweets",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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…"
}/twitter/user/mentions费用: 0.05 每次请求 · +0.1 / 条提及该用户的推文
返回 @ 了该用户的推文。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/mentions?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/mentions?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/mentions",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/user/followers费用: 0.05 每次请求 · +0.02 / 条资料粉丝列表
返回用户的粉丝资料列表,pageSize 最大 200,按条数计费(批量更便宜)。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
pageSize | integer | 否 | 每页条数,20–200 · 默认: 200 |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/followers?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/followers?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/followers",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/user/followings费用: 0.05 每次请求 · +0.02 / 条资料关注列表
返回用户关注的账号资料列表,pageSize 最大 200。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
pageSize | integer | 否 | 每页条数,20–200 · 默认: 200 |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/followings?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/followings?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/followings",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/user/followers_ids费用: 0.05 每次请求 · +0.005 / ID粉丝 ID 列表
只返回粉丝的用户 ID,单页最多 5000 个,适合大号批量分析。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userName | string | 是 | 推特用户名(不带 @) |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/followers_ids?userName=elonmusk" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/followers_ids?userName=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/followers_ids",
params={"userName": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"ids": [
"783214",
"12",
"…"
],
"has_next_page": true,
"next_cursor": "…"
}/twitter/user/check_follow_relationship费用: 0.05 每次请求 · 结果 0.1检查关注关系
检查 A 是否关注了 B、B 是否关注了 A。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
source_user_name | string | 是 | 用户 A |
target_user_name | string | 是 | 用户 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" const res = await fetch("https://xbluev.com/api/v1/twitter/user/check_follow_relationship?source_user_name=xbluev&target_user_name=elonmusk", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/check_follow_relationship",
params={"source_user_name": "xbluev", "target_user_name": "elonmusk"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"status": "success",
"data": {
"following": true,
"followed_by": false
}
}/twitter/user/search费用: 0.05 每次请求 · +0.1 / 条搜索用户
按关键词搜索账号。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | 关键词 |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/user/search?query=creator" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/user/search?query=creator", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/user/search",
params={"query": "creator"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/tweet/advanced_search费用: 0.05 每次请求 · +0.1 / 条高级搜索推文
支持 X 高级搜索语法,例如 from:、since:、min_faves:、lang:。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | 搜索语句 |
queryType | string | 否 | Latest(最新)或 Top(热门) · 默认: Latest |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweet/advanced_search?query=AI%20lang%3Azh%20min_faves%3A100" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweet/advanced_search?query=AI%20lang%3Azh%20min_faves%3A100", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweet/advanced_search",
params={"query": "AI lang:zh min_faves:100"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/tweets费用: 0.05 每次请求 · +0.1 / 条按 ID 获取推文
按推文 ID 获取推文详情和互动数据,多个 ID 用逗号分隔。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tweet_ids | string | 是 | 推文 ID,逗号分隔 |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweets?tweet_ids=1846987139428634858" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweets?tweet_ids=1846987139428634858", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweets",
params={"tweet_ids": "1846987139428634858"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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"
}
}
]
}/twitter/tweet/replies费用: 0.05 每次请求 · +0.1 / 条推文回复
返回某条推文下的回复。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tweetId | string | 是 | 推文 ID |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweet/replies?tweetId=1846987139428634858" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweet/replies?tweetId=1846987139428634858", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweet/replies",
params={"tweetId": "1846987139428634858"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/tweet/quotes费用: 0.05 每次请求 · +0.1 / 条推文引用
返回引用了某条推文的推文。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tweetId | string | 是 | 推文 ID |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweet/quotes?tweetId=1846987139428634858" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweet/quotes?tweetId=1846987139428634858", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweet/quotes",
params={"tweetId": "1846987139428634858"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/tweet/retweeters费用: 0.05 每次请求 · +0.1 / 条转发者
返回转发了某条推文的用户。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tweetId | string | 是 | 推文 ID |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweet/retweeters?tweetId=1846987139428634858" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweet/retweeters?tweetId=1846987139428634858", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweet/retweeters",
params={"tweetId": "1846987139428634858"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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": "…"
}/twitter/tweet/thread_context费用: 0.05 每次请求 · +0.1 / 条推文串上下文
返回推文所在的整串对话。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tweetId | string | 是 | 推文 ID |
cursor | string | 否 | 分页游标,首次请求留空,之后传上一页返回的 next_cursor |
请求示例
curl "https://xbluev.com/api/v1/twitter/tweet/thread_context?tweetId=1846987139428634858" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/tweet/thread_context?tweetId=1846987139428634858", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/tweet/thread_context",
params={"tweetId": "1846987139428634858"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"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
}/twitter/trends费用: 0.05 每次请求 · +0.1 / 条热门趋势
按地区(WOEID)获取 X 热门趋势,1 为全球。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
woeid | integer | 是 | 地区 WOEID,1 = 全球,23424977 = 美国,23424856 = 日本 |
请求示例
curl "https://xbluev.com/api/v1/twitter/trends?woeid=1" \
-H "X-API-Key: $XBLUEV_API_KEY" const res = await fetch("https://xbluev.com/api/v1/twitter/trends?woeid=1", {
headers: { "X-API-Key": process.env.XBLUEV_API_KEY }
});
console.log(res.headers.get("X-Points-Cost"), await res.json()); import os, requests
r = requests.get(
"https://xbluev.com/api/v1/twitter/trends",
params={"woeid": "1"},
headers={"X-API-Key": os.environ["XBLUEV_API_KEY"]},
)
print(r.headers["X-Points-Cost"], r.json()) 返回示例
{
"status": "success",
"trends": [
{
"trend": {
"name": "#AI",
"rank": 1,
"meta_description": "120K posts"
}
}
]
}