{"uid":"cap_tgcEwbHvHTlBKkL0QL5zt","slug":"twitr-sh-x-twitter-read-api-b69e610b","name":"twitr.sh X/Twitter Read API","description":"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.","url":"https://twitr.sh/api/tools/x_read","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","description":"Tweet ID, user ID, or username (depends on resource)."},"ids":{"type":"array","items":{"type":"string"},"description":"batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames."},"count":{"type":"integer","description":"trends: number of trends to return."},"woeid":{"type":"integer","description":"trends: region WOEID (default 1 = worldwide)."},"source":{"type":"string","description":"check-follower: source username."},"target":{"type":"string","description":"check-follower: target username."},"resource":{"enum":["get-tweet","get-user","batch-tweets","batch-users","check-follower","trends","article","followers-you-know","download-media"],"type":"string","description":"Which read operation to run."},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"Mandatory for followers-you-know: max results, billed per result."}}},"responseSchema":{"type":"json","example":{"items":[{"id":"2079908425904042170","text":"Ship early, ship often.","createdAt":"2026-02-24T10:05:00.000Z","likeCount":4210,"retweetCount":512,"authorUsername":"vercel"}],"runId":"tw_example","payment":{"amount":"0.001200","currency":"USD","protocol":"x402"},"duration":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wk6JGSRY5n-w821FhL-sY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Read live X/Twitter data — look up tweets, user profiles, follower relationships, trending topics, articles, and media — pay per call in USDC with no API key required","exampleAgentPrompt":"Can you look up the tweet with ID 1234567890123456789 on X and also grab the full profile for username @elonmusk? Use the twitr.sh read API — no API key needed, just pay per call in USDC.","exampleUseCases":[{"title":"Verify viral tweet authenticity","prompt":"Can you pull the actual tweet with ID 1798000012345678901 from X so I can see the exact text, timestamp, and engagement numbers — I want to verify what it really says before sharing it?"},{"title":"Check influencer follow relationship","prompt":"Can you check whether the account @naval actually follows @paulg on X? I want to confirm the relationship before mentioning it in my newsletter."},{"title":"Monitor regional trending topics","prompt":"What are the top 10 trending topics on X right now in the United Kingdom — can you fetch the trends for WOEID 23424975?"}],"resultDescription":"Returns structured JSON containing the requested data: tweet objects (text, author, timestamp, engagement metrics), user profile objects (bio, follower count, following count, verification status), boolean follower relationship, ranked list of trending topics with tweet volumes, extracted article text, or downloaded media URLs — depending on the resource type called.","failureModes":["Invalid or deleted tweet ID returns not-found error; call is not charged","Suspended or private user account returns access-denied error; call is not charged","Invalid WOEID returns error for trends endpoint","Batch input exceeding 100 IDs returns validation error","Missing required resource-specific fields (e.g. source/target for check-follower) returns parameter error","Network or upstream X API outage returns 503; call is not charged on failure"],"whenToPreferThis":"Choose this endpoint when you need live, structured X/Twitter data without setting up a Twitter developer account or managing API keys. Ideal for agents that need occasional or event-driven reads (single tweet lookup, profile enrichment, follower checks, trending topics) and want pay-as-you-go USDC billing with zero-charge guarantees on failed calls. Prefer over Twitter's own API when avoiding OAuth setup friction matters, or when you need a unified multi-resource read interface (tweets, users, trends, articles, media) under one endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:18.276Z","isFirstParty":false}