Tools and guides for growing on XCheck your monetization eligibility
🔥 HOTX (Twitter) data API · MCP

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.

Base URLhttps://xbluev.com/api/v1
Compared with the official X API
Official X APIXBlueV 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 accessDeveloper account + reviewSign up, create a key — done
Monthly fee / minimumPrepaid credits, billed per readNone · from 0.05 points per request
Network—⚡ Global CDN access
Official prices: X API pay-per-use, $0.005 per post read and $0.010 per user read (docs.x.com, 2026). Our dollar prices convert points at the monthly plan rate ($5.9 = 1,600 points ≈ $0.0037 per point) and assume typical page sizes. docs.x.com ↗
Pay per resultFrom 0.05 points per request
One key, one headerX-API-Key authentication
REST + JSONWorks with any language
60 requests / minutePer key, with rate-limit headers

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.

16 read-only toolsStreamable HTTPSame points & limits as REST
1

Choose an API key

Your key is filled into every config below automatically.

Sign in to get your key
2

Choose your AI client

3

Install

Config file~/.cursor/mcp.json (global) or .cursor/mcp.json in a project

  1. Click “Add to Cursor” and confirm in the Cursor window that opens.
  2. Or merge the config below into mcp.json.
  3. Check that xbluev is green under Settings → MCP.
4

Test & try it

Try asking your AI
🔒 Keys are secrets: keep them in your client config, never in chats or public repos. One-click links pass the key to the app on your own computer only. AI-readable docs (Markdown) ↗Download the XBlueV Skill (.zip)https://xbluev.com/api/mcp

Quick start

  1. 1

    Sign in and create an API key below.

  2. 2

    Send it in the X-API-Key header with every request.

  3. 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-CostPoints charged for this request
X-Points-BalanceYour balance after this request
X-Result-CountResults counted for billing
X-RateLimit-RemainingRequests 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.

WhatPoints
Every request (minimum, even with 0 results)0.05
Each post, user or search result0.1
Each follower / following profile0.02
Each follower ID0.005
RequestResultsPoints
Post search00.05
Post search10.15
Post search50.55
Post search202.05
Followers (pageSize=200)2004.05
Follower IDs5,00025.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

HTTPcodeMeaning
400missing_parameterA required parameter is missing.
401missing_api_key / invalid_api_keyNo key, or the key is wrong or revoked.
402insufficient_pointsYour points balance is empty.
404unknown_endpointThe path is not an available endpoint.
429rate_limitedOver 60 requests per minute. See Retry-After.
502 / 504upstream_error / upstream_timeoutThe 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

GET/twitter/user/infoCost: 0.05 per request · 0.1 for the result

Get user profile

Profile for a username: followers, following, bio, blue-check status, avatar and more.

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)

Example request

curl "https://xbluev.com/api/v1/twitter/user/info?userName=elonmusk" \
  -H "X-API-Key: $XBLUEV_API_KEY"
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": "…"
  }
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/batch_info_by_idsCost: 0.05 per request · +0.1 / result

Batch user profiles

Profiles for several user IDs at once, comma-separated.

Parameters

NameTypeRequiredDescription
userIdsstringYesComma-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"
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": "…"
    }
  ]
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/last_tweetsCost: 0.05 per request · +0.1 / result

Latest posts by user

A user's latest posts, newest first, about 20 per page.

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)
includeRepliesbooleanNoInclude replies · Default: false
cursorstringNoPagination 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"
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…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/mentionsCost: 0.05 per request · +0.1 / result

Mentions of a user

Posts that mention the user.

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/followersCost: 0.05 per request · +0.02 / profile

Followers

Profiles of the user's followers. pageSize up to 200, billed per profile (cheap in bulk).

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)
pageSizeintegerNoPage size, 20–200 · Default: 200
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/followingsCost: 0.05 per request · +0.02 / profile

Following

Profiles of accounts the user follows. pageSize up to 200.

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)
pageSizeintegerNoPage size, 20–200 · Default: 200
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/followers_idsCost: 0.05 per request · +0.005 / ID

Follower IDs

Follower user IDs only, up to 5,000 per page — ideal for large-account analysis.

Parameters

NameTypeRequiredDescription
userNamestringYesX username (without @)
cursorstringNoPagination 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"
Example response
{
  "ids": [
    "783214",
    "12",
    "…"
  ],
  "has_next_page": true,
  "next_cursor": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/user/check_follow_relationshipCost: 0.05 per request · 0.1 for the result

Check follow relationship

Whether A follows B and whether B follows A.

Parameters

NameTypeRequiredDescription
source_user_namestringYesUser A
target_user_namestringYesUser 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"
Example response
{
  "status": "success",
  "data": {
    "following": true,
    "followed_by": false
  }
}

Try it

Your key stays in this browser tab only.
GET/twitter/tweetsCost: 0.05 per request · +0.1 / result

Posts by ID

Post details and engagement for one or more post IDs, comma-separated.

Parameters

NameTypeRequiredDescription
tweet_idsstringYesComma-separated post IDs

Example request

curl "https://xbluev.com/api/v1/twitter/tweets?tweet_ids=1846987139428634858" \
  -H "X-API-Key: $XBLUEV_API_KEY"
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"
      }
    }
  ]
}

Try it

Your key stays in this browser tab only.
GET/twitter/tweet/repliesCost: 0.05 per request · +0.1 / result

Replies to a post

Replies under a post.

Parameters

NameTypeRequiredDescription
tweetIdstringYesPost ID
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/tweet/quotesCost: 0.05 per request · +0.1 / result

Quotes of a post

Posts that quote a post.

Parameters

NameTypeRequiredDescription
tweetIdstringYesPost ID
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/tweet/retweetersCost: 0.05 per request · +0.1 / result

Reposters

Users who reposted a post.

Parameters

NameTypeRequiredDescription
tweetIdstringYesPost ID
cursorstringNoPagination 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"
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": "…"
}

Try it

Your key stays in this browser tab only.
GET/twitter/tweet/thread_contextCost: 0.05 per request · +0.1 / result

Thread context

The whole thread a post belongs to.

Parameters

NameTypeRequiredDescription
tweetIdstringYesPost ID
cursorstringNoPagination 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"
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
}

Try it

Your key stays in this browser tab only.

Related tools and guides