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 on Base mainnet

quick start

Call Twitter / X in 30 seconds

curl — with a credits API key

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

curl — no key: the x402 challenge

# call without payment to inspect the 402 challenge
curl -i 'https://fetcher.sh/api/twitter/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 — see credits.

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.

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.

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

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