Skip to content

X data for your AI agents, priced per call.

Profiles, tweets, search and followers over REST or MCP. Every call has a fixed token price, known before you make it.

Get your API keyRead the docs

1,000 free tokens on signup · no card · failed calls refunded

From signup to your first paid call in three steps

One balance, one key, one price per endpoint. Watch a call spend its tokens: pick an endpoint in the console.

  1. Sign up, confirm your email

    Your account starts with 1,000 tokens. No card, no plan to pick.

  2. Create your API key

    One key per account, shown once. Send it as the x-api-key header.

  3. Each call spends its price

    Every response carries x-tokens-cost and x-tokens-remaining. Calls that fail on our side are refunded.

Try it now

balance1,000tokens

Built for AI agents

Connect your agent through the MCP server, and add skills that teach it which tool fits a task and what it will cost.

  • MCP server with 9 tools

    Search, profiles, threads, followers, lists and trends as read-only tools for Claude, Codex, Muse Code, Cursor, VS Code and any MCP client.

  • Skills for real tasks

    Account research, topic sentiment, thread digests and monitoring, in the open Agent Skills format.

  • Spend you can see

    Every tool names its price and every result ends with the cost and your balance. Failed calls are refunded.

Set up your agentSkills on GitHub
Terminal: add the MCP server
claude mcp add --transport http xscraper \
  https://mcp.xscraper.online/mcp \
  --header "x-api-key: $XSCRAPER_API_KEY"
Claude Code: add the skills
/plugin marketplace add ensp1re/xscraper-agent-kit
/plugin install xscraper@xscraper

Pricing, per call

20 endpoints, all GET. Flat endpoints cost the same every time. Paged endpoints cost a base price plus a per-page amount, so the price grows with the count you ask for.

Browse the reference
EndpointMinMax
Tweets
User tweets/users/tweets/:username37
Latest tweet/users/latest_tweet/:username11
User tweets and replies/users/replies/:username37
User tweets by ID/users/tweets_by_user_id/:userId37
User tweets and replies by ID/users/replies_by_user_id/:userId37
Liked tweets/users/likes/:username48
Tweet by ID/tweets/:tweetId11
Tweet replies/tweets/:tweetId/replies44
Tweet quotes/tweets/:tweetId/quotes44
Search
Search profiles/users/search_profiles46
Search tweets/tweets/search614
Advanced search/tweets/advanced_search812
Profiles
Profile by username/users/profile_by_username/:username11
Profile by user ID/users/profile_by_userid/:userId33
Username to user ID/users/user_id/:username11
Social graph
Followers/users/followers/:userId44
Following/users/following/:userId44
Lists
List tweets/lists/:listId/tweets37
Trends
Trends/trends22
Account
Token balance/balance00

Need one user ID, not an API? Try the free Twitter ID finder, no account needed.

Questions

Which AI tools does it work with?

Any MCP client: Claude Code, Codex, Muse Code, Claude Desktop, Cursor, VS Code and others, through the hosted server or npx xscraper-mcp. The skills work in Claude Code, Codex, Muse Code, Cursor, Copilot and other agents that read the Agent Skills format.

What does a token buy?

A profile lookup costs 1 token. Endpoints that page through results cost a base price plus a per-page amount, so asking for 100 tweets costs more than asking for 5. The pricing table lists every endpoint.

Am I charged when a call fails?

Not when it fails on our side. Tokens are taken when the call starts and returned automatically on errors and rate limits. A not-found answer (the user or tweet does not exist) is a real answer and is charged.

What happens when I run out?

Calls return HTTP 402 with the price and your balance. Nothing is billed to a card, because there is no card.

Can I buy more tokens?

Not yet. Paid top-ups are planned. For now every account gets 1,000 tokens after confirming its email.

Is there a rate limit?

Yes, 100 requests per minute per key. Responses include X-RateLimit headers, and a 429 tells you when to retry.

Why only one API key?

It keeps the free tokens fair. You can rotate your key at any time from the dashboard.

1,000 tokens are waiting for you.

Create an account, confirm your email, make your first call.

Create account