{"slug":"twitr-sh-api-tools-x-timeline-a063ba","title":"Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, o","host":"twitr.sh","method":"POST","resource":"https://twitr.sh/api/tools/x_timeline","category":"other","description":"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 ","price_listed":0.12,"price_asked":0.12,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":262,"reported_calls_30d":16,"reported_payers_30d":3,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"id":"elonmusk","kind":"user-tweets","resultsLimit":100},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"id":{"description":"User ID/username or tweet ID (depends on kind).","type":"string"},"includeParentTweet":{"type":"boolean"},"includeReplies":{"type":"boolean"},"kind":{"description":"Which timeline to fetch.","enum":["user-tweets","user-replies","user-likes","user-media","user-mentions","followers","following","verified-followers","tweet-replies","tweet-quotes","tweet-thread","tweet-favoriters","tweet-retweeters"],"type":"string"},"language":{"type":"string"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"minFaves":{"type":"integer"},"resultsLimit":{"description":"MANDATORY: max items returned, billed per item.","maximum":10000,"minimum":1,"type":"integer"},"verifiedOnly":{"type":"boolean"}},"required":["kind","id","resultsLimit"],"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.12,"price_match":true,"latency_ms":262,"error":null}],"description_full":"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.","last_updated":"2026-09-24T00:56:49.732Z","schemes":["upto"]}