{"api":"v1","generated_at":"2026-09-15T21:51:37.878Z","licence":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"TOLL, with a link to the page cited"},"page":"https://tollindex.com/e/twitr-sh-api-tools-x-timeline-4cad5f","pinned_page":"https://tollindex.com/e/twitr-sh-api-tools-x-timeline-4cad5f/at/2026-09-15T21-20Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T21:20:12.737Z","snapshot_stamp":"2026-09-15T21-20Z","endpoint":{"slug":"twitr-sh-api-tools-x-timeline-4cad5f","canonical_url":"https://twitr.sh/api/tools/x_timeline","resource":"https://twitr.sh/api/tools/x_timeline","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"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 accounts by activity.","service_name":null,"declared_category":"api","declared_tags":["twitter","x","timeline","user-tweets","feed","replies","quotes","retweeters","mentions","history","social","agent","x402"],"route_template":null,"registry_updated":"2026-09-15T17:27:16.751Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"tools x timeline","category":"communications","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T21:20:12.737Z","observation_began":"2026-09-10"},"presence":{"listed_now":true,"first_absent_at":null,"delisting_confirmed_at":null,"events":[{"registry":"cdp","at":"2026-09-10T19:08:24.178Z","event":"listed"}]},"accepts":[{"registry":"cdp","ordinal":0,"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","asset_name":"USD Coin","symbol":"USDC","decimals":6,"amount_display":"0.12 USDC","amount_units":0.12,"decimals_known":true,"pay_to":"0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","scheme":"upto"}],"counters":{"observed_at":"2026-09-15T21:20:12.737Z","calls_30d":9,"unique_payers_30d":3,"last_called_at":"2026-09-15T17:27:16.565Z"},"validation":{"latest":{"observed_at":"2026-09-15T04:40:57.814Z","state":"pass","failed_checks":[],"endpoint_http_status":402,"run_id":"daily-2026-09-15"},"uptime":[{"days":7,"observed":5,"passed":5,"ratio":1},{"days":30,"observed":5,"passed":5,"ratio":1},{"days":90,"observed":5,"passed":5,"ratio":1}],"history_90d":[{"observed_at":"2026-09-15T04:40:57.814Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T04:36:44.141Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T04:35:05.574Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T06:51:18.259Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T10:25:36.458Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-11","state_changed":true}]},"seller":{"wallet":"0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","page":"https://tollindex.com/seller/0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","endpoints":7,"hosts":2},"reports":0,"registry_record":{"cdp":[{"type":"http","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2","facilitatorAddress":"0x93F6601151cCB08F333AB4B1CCcfb1e188c0bE44","assetTransferMethod":"permit2"},"payTo":"0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","amount":"120000","scheme":"upto","network":"eip155:8453","extensions":{"eip2612GasSponsoring":{"info":{"version":"1","description":"The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract."},"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["from","asset","spender","amount","nonce","deadline","signature","version"],"properties":{"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the sender."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the ERC-20 token contract."},"nonce":{"type":"string","pattern":"^[0-9]+$","description":"The current nonce of the sender."},"amount":{"type":"string","pattern":"^[0-9]+$","description":"The amount to approve (uint256). Typically MaxUint."},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the spender (Canonical Permit2)."},"version":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)*$","description":"Schema version identifier."},"deadline":{"type":"string","pattern":"^[0-9]+$","description":"The timestamp at which the signature expires."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"The 65-byte concatenated signature (r, s, v) as a hex string."}}}}},"maxTimeoutSeconds":300}],"quality":{"lastCalledAt":"2026-09-15T17:27:16.565Z","l30DaysTotalCalls":9,"l30DaysUniquePayers":3},"resource":"https://twitr.sh/api/tools/x_timeline","extensions":{"bazaar":{"info":{"input":{"body":{"id":"elonmusk","kind":"user-tweets","resultsLimit":100},"type":"http","method":"POST","bodyType":"json"},"output":{"type":"json","example":{"items":[{"id":"1893710452812718080","text":"This is a great thread, thanks for sharing.","createdAt":"2026-02-24T10:05:00.000Z","likeCount":1180,"authorUsername":"elonmusk"}],"runId":"tw_example","payment":{"amount":"0.120000","currency":"USD","protocol":"x402"},"duration":3}}},"tags":["twitter","x","timeline","user-tweets","feed","replies","quotes","retweeters","mentions","history","social","agent","x402"],"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["kind","id","resultsLimit"],"properties":{"id":{"type":"string","description":"User ID/username or tweet ID (depends on kind)."},"kind":{"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","description":"Which timeline to fetch."},"language":{"type":"string"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"MANDATORY: max items returned, billed per item."},"verifiedOnly":{"type":"boolean"},"includeReplies":{"type":"boolean"},"includeParentTweet":{"type":"boolean"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object"},"description":"Returned items. Shape varies per tool — see each tool's outputSample for a concrete example."},"runId":{"type":"string","description":"Run ID for debugging/audit."},"payment":{"type":"object","description":"Settlement summary (protocol, amount, currency)."},"duration":{"type":"integer","description":"Run duration in seconds."}}}}}}},"category":"api","discoverable":true},"eip2612GasSponsoring":{"info":{"version":"1","description":"The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract."},"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["from","asset","spender","amount","nonce","deadline","signature","version"],"properties":{"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the sender."},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the ERC-20 token contract."},"nonce":{"type":"string","pattern":"^[0-9]+$","description":"The current nonce of the sender."},"amount":{"type":"string","pattern":"^[0-9]+$","description":"The amount to approve (uint256). Typically MaxUint."},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"The address of the spender (Canonical Permit2)."},"version":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)*$","description":"Schema version identifier."},"deadline":{"type":"string","pattern":"^[0-9]+$","description":"The timestamp at which the signature expires."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"The 65-byte concatenated signature (r, s, v) as a hex string."}}}}},"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 accounts by activity.","lastUpdated":"2026-09-15T17:27:16.751Z","x402Version":2}]}}