{"slug":"twitr-sh-api-tools-x-read-2ef92b","title":"Read live X/Twitter data","host":"twitr.sh","method":"POST","resource":"https://twitr.sh/api/tools/x_read","category":"search","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","price_listed":0.0024,"price_asked":0.0024,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":251,"reported_calls_30d":12,"reported_payers_30d":6,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"id":"2079908425904042170","resource":"get-tweet"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"allOf":[{"if":{"properties":{"resource":{"const":"followers-you-know"}}},"then":{"required":["resultsLimit"]}}],"properties":{"count":{"description":"trends: number of trends to return.","type":"integer"},"id":{"description":"Tweet ID, user ID, or username (depends on resource).","type":"string"},"ids":{"description":"batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames.","items":{"type":"string"},"type":"array"},"resource":{"description":"Which read operation to run.","enum":["get-tweet","get-user","batch-tweets","batch-users","check-follower","trends","article","followers-you-know","download-media"],"type":"string"},"resultsLimit":{"description":"Mandatory for followers-you-know: max results, billed per result.","maximum":10000,"minimum":1,"type":"integer"},"source":{"description":"check-follower: source username.","type":"string"},"target":{"description":"check-follower: target username.","type":"string"},"woeid":{"description":"trends: region WOEID (default 1 = worldwide).","type":"integer"}},"required":["resource"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"duration":{"description":"Run duration in seconds.","type":"integer"},"items":{"description":"Returned items. Shape varies per tool — see each tool's outputSample for a concrete example.","items":{"type":"object"},"type":"array"},"payment":{"description":"Settlement summary (protocol, amount, currency).","type":"object"},"runId":{"description":"Run ID for debugging/audit.","type":"string"}},"required":["items"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.0024,"price_match":true,"latency_ms":251,"error":null}],"description_full":"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.","last_updated":"2026-09-24T00:54:20.212Z","schemes":["exact"]}