X (Twitter) data API, paid with points
Profiles, posts, followers, search and trends through one simple REST API. Create a key, call it from any language, and pay per result with your XBlueV points — no subscription, no minimum.
https://xbluev.com/api/v1| Official X API | XBlueV API | |
|---|---|---|
| 1,000 posts | $5.00 | $0.37813× cheaper |
| 1,000 user profiles | $10.00 | $0.55318× cheaper |
| 1,000 follower profiles (bulk) | $10.00 | $0.075135× cheaper |
| Getting access | Developer account + review | Sign up, create a key — done |
| Monthly fee / minimum | Prepaid credits, billed per read | None · from 0.05 points per request |
| Network | — | ⚡ Global CDN access |
Connect your AI in one click
Give Cursor, Claude, VS Code, Codex and more live X data. Pick a key, pick your client, click install.
Choose your AI client
Install
Config file~/.cursor/mcp.json (global) or .cursor/mcp.json in a project
- Click “Add to Cursor” and confirm in the Cursor window that opens.
- Or merge the config below into mcp.json.
- Check that xbluev is green under Settings → MCP.
Config file.vscode/mcp.json in your project
- Click “Install in VS Code” and confirm inside VS Code.
- Or save the config below as .vscode/mcp.json.
- In Copilot Chat agent mode, open the tools list and enable xbluev.
- Click “Copy install command” and run it in your terminal.
- Type /mcp in Claude Code and check xbluev is connected.
Config filemacOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
- Requires Node.js 18+.
- Claude Desktop → Settings → Developer → Edit Config, then merge the config below.
- Fully quit and reopen Claude Desktop; xbluev appears under the tools icon.
Config file~/.codeium/windsurf/mcp_config.json
- Windsurf → Settings → Cascade → MCP Servers → View raw config.
- Merge the config below, save and press Refresh.
Config file~/.codex/config.toml
Set the key in the terminal that starts Codex (PowerShell: $env:XBLUEV_API_KEY="…")
- Append the config below to config.toml.
- Set the XBLUEV_API_KEY environment variable and restart Codex.
- Type /mcp in Codex to see xbluev.
Config fileCline → MCP Servers → Configure → cline_mcp_settings.json
- In the Cline panel, open MCP Servers → Configure MCP Servers.
- Merge the config below and save; Cline connects automatically.
Config fileWorkBuddy custom MCP settings
- Open WorkBuddy’s custom MCP settings.
- Merge the mcpServers config below and save.
Config fileAny MCP client that supports Streamable HTTP
- Choose Streamable HTTP (not SSE) and use the url below.
- Send X-API-Key, or Authorization: Bearer <your key>.
Test & try it
https://xbluev.com/api/mcp Quick start
- 1
Sign in and create an API key below.
- 2
Send it in the X-API-Key header with every request.
- 3
Each response tells you what it cost in the X-Points-Cost header.
curl "https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk" \
-H "X-API-Key: xbv_your_key_here" Your API keys
Keys are shown masked; use Copy to get the full key. You can have up to 5 active keys.
Authentication
Every request must include your key in the X-API-Key header. Keep keys secret — anyone with your key can spend your points. If a key leaks, revoke it and create a new one.
X-API-Key: xbv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Response headers
X-Points-Cost | Points charged for this request |
X-Points-Balance | Your balance after this request |
X-Result-Count | Results counted for billing |
X-RateLimit-Remaining | Requests left this minute |
Pricing
You pay a small fee per request plus a fee per result returned. Requests that fail upstream are never charged. Fractions add up and are deducted one whole point at a time.
| What | Points |
|---|---|
| Every request (minimum, even with 0 results) | 0.05 |
| Each post, user or search result | 0.1 |
| Each follower / following profile | 0.02 |
| Each follower ID | 0.005 |
| Request | Results | Points |
|---|---|---|
| Post search | 0 | 0.05 |
| Post search | 1 | 0.15 |
| Post search | 5 | 0.55 |
| Post search | 20 | 2.05 |
| Followers (pageSize=200) | 200 | 4.05 |
| Follower IDs | 5,000 | 25.05 |
Every plan pays with its points balance. Members simply get more points: monthly 1,600 points a month, yearly 27,000 points for the whole year, credited at once.
Errors
| HTTP | code | Meaning |
|---|---|---|
| 400 | missing_parameter | A required parameter is missing. |
| 401 | missing_api_key / invalid_api_key | No key, or the key is wrong or revoked. |
| 402 | insufficient_points | Your points balance is empty. |
| 404 | unknown_endpoint | The path is not an available endpoint. |
| 429 | rate_limited | Over 60 requests per minute. See Retry-After. |
| 502 / 504 | upstream_error / upstream_timeout | The data source failed. You are not charged. |
Errors always look like this:
{
"error": {
"code": "insufficient_points",
"message": "Not enough points. Top up at https://xbluev.com/en/pricing"
}
} FAQ
Can I try it for free?
Yes. Every new account can claim free points daily, and one request starts at just 0.05 points — enough for dozens of test calls. Use the “Try it” box on each endpoint to test without writing code.
Are there hidden fees?
No. You pay exactly what the X-Points-Cost header shows: a small per-request fee plus a per-result fee. No monthly fee, no minimum, and failed upstream requests are never charged.
How do I use it?
Create a key in “API keys”, then send it in the X-API-Key header with any GET request to https://xbluev.com/api/v1/…. Every endpoint below has cURL, JavaScript and Python examples.
Is the data up to date?
Yes. Every request is fetched live from X at the moment you call it — nothing is served from an old cache.
What happens when I run out of points?
Requests return 402 insufficient_points until you top up. Claim daily points or upgrade on the pricing page.
Is there a rate limit?
60 requests per minute per key. Check the X-RateLimit-Remaining header; when you hit the limit you get 429 with a Retry-After header.
My key leaked. What should I do?
Delete it in “API keys” right away and create a new one. Deleted keys stop working immediately.
Can I use it from the browser?
Yes, CORS is enabled. But never put your key in public front-end code — call the API from your server.
Endpoints
/twitter/user/infoCost: 0.05 per request · 0.1 for the resultGet user profile
Profile for a username: followers, following, bio, blue-check status, avatar and more.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
Example request
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()) Example response
{
"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_idsCost: 0.05 per request · +0.1 / resultBatch user profiles
Profiles for several user IDs at once, comma-separated.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userIds | string | Yes | Comma-separated user IDs |
Example request
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()) Example response
{
"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_tweetsCost: 0.05 per request · +0.1 / resultLatest posts by user
A user's latest posts, newest first, about 20 per page.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
includeReplies | boolean | No | Include replies · Default: false |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/mentionsCost: 0.05 per request · +0.1 / resultMentions of a user
Posts that mention the user.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/followersCost: 0.05 per request · +0.02 / profileFollowers
Profiles of the user's followers. pageSize up to 200, billed per profile (cheap in bulk).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
pageSize | integer | No | Page size, 20–200 · Default: 200 |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/followingsCost: 0.05 per request · +0.02 / profileFollowing
Profiles of accounts the user follows. pageSize up to 200.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
pageSize | integer | No | Page size, 20–200 · Default: 200 |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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_idsCost: 0.05 per request · +0.005 / IDFollower IDs
Follower user IDs only, up to 5,000 per page — ideal for large-account analysis.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
userName | string | Yes | X username (without @) |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"ids": [
"783214",
"12",
"…"
],
"has_next_page": true,
"next_cursor": "…"
}/twitter/user/check_follow_relationshipCost: 0.05 per request · 0.1 for the resultCheck follow relationship
Whether A follows B and whether B follows A.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
source_user_name | string | Yes | User A |
target_user_name | string | Yes | User B |
Example request
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()) Example response
{
"status": "success",
"data": {
"following": true,
"followed_by": false
}
}/twitter/user/searchCost: 0.05 per request · +0.1 / resultSearch users
Search accounts by keyword.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Keyword |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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_searchCost: 0.05 per request · +0.1 / resultAdvanced post search
Supports X advanced search operators such as from:, since:, min_faves:, lang:.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
queryType | string | No | Latest or Top · Default: Latest |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/tweetsCost: 0.05 per request · +0.1 / resultPosts by ID
Post details and engagement for one or more post IDs, comma-separated.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tweet_ids | string | Yes | Comma-separated post IDs |
Example request
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()) Example response
{
"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/repliesCost: 0.05 per request · +0.1 / resultReplies to a post
Replies under a post.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tweetId | string | Yes | Post ID |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/quotesCost: 0.05 per request · +0.1 / resultQuotes of a post
Posts that quote a post.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tweetId | string | Yes | Post ID |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/retweetersCost: 0.05 per request · +0.1 / resultReposters
Users who reposted a post.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tweetId | string | Yes | Post ID |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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_contextCost: 0.05 per request · +0.1 / resultThread context
The whole thread a post belongs to.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tweetId | string | Yes | Post ID |
cursor | string | No | Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response. |
Example request
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()) Example response
{
"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/trendsCost: 0.05 per request · +0.1 / resultTrends
X trends by location (WOEID); 1 is worldwide.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
woeid | integer | Yes | Location WOEID: 1 = worldwide, 23424977 = US, 23424856 = Japan |
Example request
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()) Example response
{
"status": "success",
"trends": [
{
"trend": {
"name": "#AI",
"rank": 1,
"meta_description": "120K posts"
}
}
]
}