Twitter / X data API

Search tweets, resolve profiles by handle or ID, and pull timelines, replies, followers, lists, and trends. No account, no OAuth — pay per call with x402 or spend a prepaid credit balance with one API key.

15 endpoints$0.002 – $0.005 per callGET · JSON envelopeUSDC · gas sponsored

pay from any of:BasePolygonArbitrumMonadSolana

/api/handle/:handle
/api/handle/:handle/about
/api/list/:id/members
/api/list/:id/tweets
/api/search
/api/search/users
/api/trends
/api/tweet/:id
/api/tweet/:id/replies
/api/tweet/:id/retweeters
/api/user/:id
/api/user/:id/followers
/api/user/:id/followings
/api/user/:id/replies
/api/user/:id/tweets

Also covers: x.com · tweets · retweets

the main one

start here

$0.005 per call

Search

/api/search

The query goes straight to X's own search, so its operators work: from:, to:, since:, until:, min_faves:, filter:.

try an example

queryrequiredsortoptionalcursoroptional

API key — optional · stays in your browser

Try it /api/search?query=from%3AOpenAI&sort=Latest

opens the payment page in a new tab · $0.005 per call

quick start

Call Twitter / X in 30 seconds

curl — with a credits API key

curl -H 'Authorization: Bearer bby_live_...' \
  'https://twitter.fetcher.sh/api/search?query=x402'

curl — no key: the x402 challenge

# call without payment to inspect the 402 challenge
curl -i 'https://twitter.fetcher.sh/api/search?query=x402'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

No key yet? Top up once (minimum $1) and the first response contains your bby_live_ key — one balance works across every fetcher.sh service. Generate one.

mcp

Add Twitter / X to Claude or Cursor

A remote MCP server scoped to this service: your agent gets these tools and nothing else, so the context cost stays small.

mcp config

{
  "mcpServers": {
    "fetcher": { "url": "https://twitter.fetcher.sh/mcp" }
  }
}

reference

All 15 Twitter / X endpoints

Click any endpoint to open its console: fill the parameters and try it live — the payable URL opens in a new tab, ready for a browser wallet.

docs

Top up once — then hammer all 15 endpoints with one key

One x402 payment funds a credit balance. Every call after that is a plain Bearer request: no signing, no chain round-trip, more requests per second. The same balance works on every fetcher.sh service.

Generate API key your first top-up creates the key — shown once

Agents: paste Set up https://twitter.fetcher.sh/skill.md into your agent — it reads the skill and sets everything up.