{"uid":"cap_ycyGgPy6EHJzKjcGOT02L","slug":"x-data-gateway-tweet-search-0f13acae","name":"X Data Gateway – Tweet Search","description":"Search posts. At least one of: words, phrase, hashtags, from, minLikes, since, until. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100","url":"https://x-data-gateway.annushka1190.workers.dev/tweets/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"from":{"type":"string","description":"Only from this username"},"since":{"type":"string","description":"YYYY-MM-DD"},"until":{"type":"string","description":"YYYY-MM-DD"},"words":{"type":"string","description":"Words that must appear"},"phrase":{"type":"string","description":"Exact phrase"},"hashtags":{"type":"string","description":"Comma-separated hashtags, no #"},"minLikes":{"type":"string","description":"Minimum likes"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yyfc7wkpEO6tVip1YD662","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search tweets on Twitter/X by keyword, phrase, user, hashtag, date range, and engagement threshold, paying per request in USDC via x402.","exampleAgentPrompt":"Search Twitter for recent tweets mentioning 'OpenAI' with the hashtag 'AI' posted since 2024-06-01, and only show me ones with at least 100 likes.","exampleUseCases":[{"title":"Brand mention monitoring","prompt":"Find all tweets mentioning 'Tesla' and 'recall' posted since 2024-05-01 — I want to see what people are saying about the latest recall news."},{"title":"Influencer tweet research","prompt":"Pull the most-liked tweets from @elonmusk from the past week — I want to see what he's been posting lately."},{"title":"Hashtag campaign analysis","prompt":"Search Twitter for tweets with the hashtag 'WorldCup2026' posted between 2024-01-01 and 2024-06-30 that have at least 500 likes so I can see the top viral posts."}],"resultDescription":"A JSON object containing an array of matching tweets (each with an id and text field) and a meta object with a next_token for pagination. Returns null next_token when no further pages exist.","failureModes":["Payment not received or insufficient USDC — returns 402 Payment Required","Invalid date format (not YYYY-MM-DD) — returns 400 Bad Request","No tweets matching the query found — returns empty data array","Rate limit or upstream Twitter API error — returns 5xx","Missing required method/type fields in input — returns 400 validation error"],"whenToPreferThis":"Choose this endpoint when you need real-time Twitter/X tweet search without setting up a Twitter developer account or managing API keys. It is ideal for AI agents that need on-demand, pay-per-call access to tweet data using USDC micropayments via x402. Prefer it over self-managed Twitter API integrations when simplicity and no-credential access are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:37.498Z","isFirstParty":false}