{"api":"v1","generated_at":"2026-09-15T21:51:18.056Z","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-search-5225dc","pinned_page":"https://tollindex.com/e/twitr-sh-api-tools-x-search-5225dc/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-search-5225dc","canonical_url":"https://twitr.sh/api/tools/x_search","resource":"https://twitr.sh/api/tools/x_search","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"description":"Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.","service_name":null,"declared_category":"api","declared_tags":["twitter","x","search","tweets","keyword","hashtag","query","social-listening","brand-monitoring","sentiment","user-search","agent","x402"],"route_template":null,"registry_updated":"2026-09-15T13:18:48.566Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"tools x search","category":"search","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.06 USDC","amount_units":0.06,"decimals_known":true,"pay_to":"0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","scheme":"upto"}],"counters":{"observed_at":"2026-09-15T21:20:12.737Z","calls_30d":58,"unique_payers_30d":7,"last_called_at":"2026-09-15T13:19:00.799Z"},"validation":{"latest":{"observed_at":"2026-09-15T04:44:49.955Z","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:44:49.955Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T04:40:18.196Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T04:38:21.029Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T06:55:00.551Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T10:30:10.188Z","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":"0xa32cCda98ba7529705a059Bd2d213Da8de10d101","assetTransferMethod":"permit2"},"payTo":"0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A","amount":"60000","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-15T13:19:00.799Z","l30DaysTotalCalls":58,"l30DaysUniquePayers":7},"resource":"https://twitr.sh/api/tools/x_search","extensions":{"bazaar":{"info":{"input":{"body":{"q":"artificial intelligence","type":"search-tweets","language":"en","minFaves":100,"resultsLimit":50},"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.060000","currency":"USD","protocol":"x402"},"duration":2}}},"tags":["twitter","x","search","tweets","keyword","hashtag","query","social-listening","brand-monitoring","sentiment","user-search","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","allOf":[{"if":{"properties":{"type":{"const":"search-users"}}},"else":{"required":["resultsLimit"]},"then":{}}],"required":["q"],"properties":{"q":{"type":"string","description":"Search query (X operator syntax supported for tweets)."},"type":{"enum":["search-tweets","search-users"],"type":"string","description":"Search tweets (default) or users."},"cursor":{"type":"string","description":"search-users: pagination cursor from a previous call's report.next_cursor."},"fromUser":{"type":"string"},"language":{"type":"string"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"sinceDate":{"type":"string","description":"YYYY-MM-DD"},"untilDate":{"type":"string","description":"YYYY-MM-DD"},"minReplies":{"type":"integer"},"exactPhrase":{"type":"string"},"minRetweets":{"type":"integer"},"excludeWords":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"search-tweets: MANDATORY max tweets returned, billed per tweet."},"verifiedOnly":{"type":"boolean"},"advancedQuery":{"type":"string","description":"Raw X search operator string appended to q."}}},"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":"Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.","lastUpdated":"2026-09-15T13:18:48.566Z","x402Version":2}]}}