{"slug":"twitr-sh-api-tools-x-search-aae661","title":"Search X/Twitter tweets with the full operator set — keyword, exact phrase, from","host":"twitr.sh","method":"POST","resource":"https://twitr.sh/api/tools/x_search","category":"search","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 top","price_listed":0.06,"price_asked":0.06,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":501,"reported_calls_30d":78,"reported_payers_30d":7,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"language":"en","minFaves":100,"q":"artificial intelligence","resultsLimit":50,"type":"search-tweets"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"allOf":[{"else":{"required":["resultsLimit"]},"if":{"properties":{"type":{"const":"search-users"}}},"then":{}}],"properties":{"advancedQuery":{"description":"Raw X search operator string appended to q.","type":"string"},"cursor":{"description":"search-users: pagination cursor from a previous call's report.next_cursor.","type":"string"},"exactPhrase":{"type":"string"},"excludeWords":{"type":"string"},"fromUser":{"type":"string"},"language":{"type":"string"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"minFaves":{"type":"integer"},"minReplies":{"type":"integer"},"minRetweets":{"type":"integer"},"q":{"description":"Search query (X operator syntax supported for tweets).","type":"string"},"resultsLimit":{"description":"search-tweets: MANDATORY max tweets returned, billed per tweet.","maximum":10000,"minimum":1,"type":"integer"},"sinceDate":{"description":"YYYY-MM-DD","type":"string"},"type":{"description":"Search tweets (default) or users.","enum":["search-tweets","search-users"],"type":"string"},"untilDate":{"description":"YYYY-MM-DD","type":"string"},"verifiedOnly":{"type":"boolean"}},"required":["q"],"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.06,"price_match":true,"latency_ms":501,"error":null}],"description_full":"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.","last_updated":"2026-09-24T15:30:59.385Z","schemes":["upto"]}