If you are an AI agent, LLM, or automated tool, a clean Markdown version of this page is available at https://twitter.fetcher.sh/index.md — optimized for AI and LLM tools.

Twitter/X public data without the official developer platform

Name: Twitter / X public data as JSON
Creator: fetcher.sh

Search tweets, resolve profiles by handle or ID, and pull timelines, replies, followers, lists, and trends. Not an official platform API. 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

compared to

What Twitter / X is not

Twitter / X compared to the official path
Path	What it is	What you set up
Official X API	Partner product — write, ads, DMs, compliance	X developer app
TwitterAPI.io / Apify	Hosted X reads with their own signup	Their API key or an actor run
twitter.fetcher.sh	Hosted GET, $0.002 – $0.005 per call	None for x402

Named comparison: Best Twitter/X public-data APIs in 2026. Alternatives: Twitter/X API alternatives. Compare: Compare Twitter/X APIs.

prices

15 GETs on this host

$0.002 – $0.005 per call in USDC. Same numbers as /prices on the directory.

Twitter / X endpoint prices
GET	What it returns	USDC / call	Page
`GET /api/handle/{handle}`	Handle	$0.005	docs
`GET /api/handle/{handle}/about`	Handle about	$0.005	docs
`GET /api/list/{id}/members`	List members	$0.005	docs
`GET /api/list/{id}/tweets`	List tweets	$0.005	docs
`GET /api/search`	Search	$0.005	docs
`GET /api/search/users`	Search users	$0.005	docs
`GET /api/trends`	Trends	$0.005	docs
`GET /api/tweet/{id}`	Tweet	$0.002	docs
`GET /api/tweet/{id}/replies`	Tweet replies	$0.005	docs
`GET /api/tweet/{id}/retweeters`	Tweet retweeters	$0.005	docs
`GET /api/user/{id}`	User	$0.005	docs
`GET /api/user/{id}/followers`	User followers	$0.005	docs
`GET /api/user/{id}/followings`	User followings	$0.005	docs
`GET /api/user/{id}/replies`	User replies	$0.005	docs
`GET /api/user/{id}/tweets`	User tweets	$0.005	docs

questions

FAQ

Is this the official X API?

No. twitter.fetcher.sh is not the official X API and not developer.x.com. It returns public tweets, profiles, search, and follower lists as JSON. Ads, DMs, and write access stay on the official platform.

Do I need X developer approval?

No. You do not create an X developer app, complete OAuth, or wait for review. Call a URL on twitter.fetcher.sh. Pay that request in USDC via x402, or spend a prepaid credit key.

Do I need an official developer account?

No. fetcher.sh is not the official Twitter, YouTube, or Google API. You do not register an app, complete OAuth, or wait for platform review. Call a URL; data comes back as JSON.

Is there a monthly minimum or subscription?

No. There is no monthly plan, no seat fee, and no minimum volume. Pay per call from $0.002. Credits never expire. A $1 credit top-up is only if you want a prepaid API key instead of paying each call.

Can I pay for a single request?

Yes. Call any endpoint with no credential and pay that one request in USDC via x402. No account, no invoice, no leftover plan.

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

This host serves 15 named Twitter / X tools at /mcp. Catalog discovery (search, describe, fetch any path) lives on mcp.fetcher.sh.

mcp config — this service

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

Specialized tools: twitter_handle, twitter_handle_about, twitter_list_members, twitter_list_tweets, twitter_search, twitter_search_users, twitter_trends, twitter_tweet, twitter_tweet_replies, twitter_tweet_retweeters, twitter_user, twitter_user_followers, twitter_user_followings, twitter_user_replies, twitter_user_tweets. Browse every service on mcp.fetcher.sh.

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.