Tool detail
x_read
Reads X/Twitter data — a tweet, user profile, batched lookups, follow checks, trends, or an article — by ID or username.
Categories: Social media
Use when
- look up one tweet or user profile by ID or username
- batch-read up to 100 tweets or user profiles at once
- check whether one X account follows another
- get trending topics for a region
- extract a long-form X article's text
Not for
- not for posting, liking or following — read-only
- not a keyword search across tweets (separate x_search tool)
Inputs
POST JSON body: resource (enum, required: get-tweet|get-user|batch-tweets|batch-users|check-follower|trends|article|followers-you-know|download-media) plus id/ids/source/target/woeid/count
Inputs undocumented: unsupported schema construct: allOf
Endpoint
- Method
POST- URL
https://twitr.sh/api/tools/x_read
Payment
- Protocol
- x402
- Listed price
- $0.0024 USDC per call on Base (varies $0.0024–$1.20 by resource)
- Payment method
- exact
- Network
- eip155:8453
- Asset
- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.
Source
- Directory
- Coinbase x402 Bazaar
- Record
- POST https://twitr.sh/api/tools/x_read
- Retrieved
- 2026-09-30T20:37:07.382Z
- Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524- Catalog built
- 2026-09-30T22:31:58.034Z