$0.0012
per call · USD Coin on Base
Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.
Endpoint
POST https://twitr.sh/api/tools/x_read7
Calls / 30d
4
Unique payers / 30d
Sep 9
Last called
exact
Payment scheme
Call this service
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPay("https://twitr.sh/api/tools/x_read", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": "2079908425904042170",
"resource": "get-tweet"
}),
});
const data = await res.json();curl -X POST \
"https://twitr.sh/api/tools/x_read" \
-H "Content-Type: application/json" \
-d '{"id":"2079908425904042170","resource":"get-tweet"}' \
-H "X-PAYMENT: <signed x402 payment>"Example response
{
"duration": 1,
"items": [
{
"authorUsername": "vercel",
"createdAt": "2026-02-24T10:05:00.000Z",
"id": "2079908425904042170",
"likeCount": 4210,
"retweetCount": 512,
"text": "Ship early, ship often."
}
],
"payment": {
"amount": "0.001200",
"currency": "USD",
"protocol": "x402"
},
"runId": "tw_example"
}Payment details
0xb5194a98dbdbb7028b585db26b972e7f0f3f826aUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913Is this your API?
Pin it to the top of Social & Community and the homepage with a featured placement.
More from Twitr & similar services
Twitr · Tools X Search
twitr.sh
Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.
Twitr · Tools X Timeline
twitr.sh
Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.
Twitr · Tools Radar
twitr.sh
Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters. Flat sub-cent price per call; the cheap first stop for what is happening right now.