{"slug":"x402-apidirect-io-v1-twitter-posts-bf4c61","title":"Search for tweets by keyword","host":"x402.apidirect.io","method":"GET","resource":"https://x402.apidirect.io/v1/twitter/posts","category":"search","description":"Search for tweets by keyword.","price_listed":0.007,"price_asked":0.007,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":276,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"query":"AI","sort_by":"most_recent"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"end_date":{"description":"Only return posts up to and including this date (YYYY-MM-DD, UTC). Must not be earlier than start_date. Can't be combined with posted_ago.","format":"date","type":"string"},"get_sentiment":{"default":false,"description":"Set to true to add AI emotion analysis to each post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any post t","type":"boolean"},"pages":{"default":1,"description":"Number of pages to fetch and merge into one response (1-20, billed per page). Fetching stops early when there are no more results.","maximum":20,"minimum":1,"type":"integer"},"posted_ago":{"description":"Only return posts from this period: 1h (past hour), 24h (past day), 7d (past week), 30d (past month), or 12m (past year). Works with both sort orders. Omit for all time. Can't be combined with start_date or end_date. Any other value returns 400.","enum":["1h","24h","7d","30d","12m"],"type":"string"},"query":{"description":"Search query (max 500 characters). Supports X's search operators (https://help.x.com/en/using-x/x-advanced-search).","maxLength":500,"minLength":1,"type":"string"},"sort_by":{"default":"most_recent","description":"Sort order for results","enum":["most_recent","relevance"],"type":"string"},"start_date":{"description":"Only return posts from this date onward (YYYY-MM-DD, UTC). Can't be combined with posted_ago.","format":"date","type":"string"}},"required":["query"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-25","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.007,"price_match":true,"latency_ms":276,"error":null}],"description_full":"Search for tweets by keyword.","last_updated":"2026-10-25T12:24:55.77Z","schemes":["exact","upto"]}