{"uid":"cap_3Ya7EXO0_bUi6JmDUpQWj","slug":"twitter-x-posts-tweets-search-0e1be9b0","name":"Twitter/X Posts & Tweets Search","description":"Twitter/X Posts & Tweets Search: the latest public tweets on X matching a keyword or phrase, newest first. Per tweet the text, author handle and name, verification, followers, likes, replies, retweets, views, language, time and URL in one schema shared by every platform; parent_id names the replied-to or quoted tweet; next_cursor gives the next page. For social listening, brand monitoring and research. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/x/search?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":200,"description":"Search text (1-200 characters)."},"cursor":{"type":"string","maxLength":512,"description":"next_cursor of the previous page."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"1910000000000000001","url":"https://x.com/synth_alpha/status/1910000000000000001","lang":"en","text":"Trying the synthwidget beta today, the dark mode is great","type":"post","author":{"handle":"synth_alpha","verified":true,"followers":1234,"display_name":"Synthetic Alpha"},"metrics":{"likes":11,"views":780,"replies":4,"reposts":2},"platform":"x","parent_id":"1910000000000000901","created_at":"2026-10-01T18:50:27.000Z","media_urls":[]},{"id":"1910000000000000002","url":"https://x.com/synth_beta/status/1910000000000000002","lang":"en","text":"synthwidget support never answered my ticket","type":"post","author":{"handle":"synth_beta","verified":false,"followers":88,"display_name":"Synthetic Beta"},"metrics":{"likes":0,"views":45,"replies":1,"reposts":0},"platform":"x","parent_id":"1910000000000000001","created_at":"2026-10-02T09:00:00.000Z","media_urls":[]}],"query":{"q":"synthetic widgets","cursor":null},"source":"public data via third-party provider; not affiliated with the platform","complete":true,"platform":"x","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":"synthcursor_2"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_marT9Kk1uzu3lqzkW5UyM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches public X (Twitter) posts by keyword or phrase, returning the latest matching tweets newest-first with full engagement metrics, author details, and pagination cursor.","exampleAgentPrompt":"Search X for the latest public tweets mentioning 'climate summit' and show me the most recent ones with their like counts and author handles.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Pull the latest tweets mentioning 'AcmeCorp' on X so I can see what customers are saying about us right now — include who posted, how many likes and replies each got, and the tweet URLs."},{"title":"Competitor sentiment research","prompt":"Search Twitter for recent posts about 'Notion AI' and give me a summary of what people are saying — show me the text, author, and engagement numbers for the newest ones."},{"title":"Event buzz tracking","prompt":"Find the most recent tweets about 'WWDC 2025' on X and page through results — start from the beginning and give me the next cursor so I can keep pulling more."}],"resultDescription":"Returns a JSON object with an array of tweet items (newest first), each containing tweet ID, URL, text, language, type, author object (handle, display name, verified flag, follower count), engagement metrics (likes, views, replies, reposts), platform, parent tweet ID for replies/quotes, creation timestamp, and media URLs. Also includes the search query echo, an as_of timestamp, a next_cursor for pagination, a request ID, and a disclaimer about data provenance.","failureModes":["Bad or malformed query input is accepted but may return zero results at no charge","No matching tweets returns an empty items array without billing","Rate limiting or upstream X API restrictions may reduce result freshness","Pagination with an invalid or expired cursor may return empty or repeat results","Very broad queries may return unrelated or low-quality tweets"],"whenToPreferThis":"Choose this endpoint when you need to search public X/Twitter posts by keyword or phrase with rich per-tweet metadata (engagement metrics, author verification, language, parent tweet linkage) in a normalized schema. Prefer it over generic web search when you specifically need X post data for social listening, brand monitoring, or trend research. It is more targeted than the cross-platform Social Search endpoint when you only need X data, and more flexible than the X User Profile Lookup when you need topic-based search rather than a specific account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:24.118Z","isFirstParty":false,"canonicalSlug":"twitter-x-posts-tweets-search-0e1be9b0"}