{"uid":"cap_jVSEFmBsVi8HudNRaiJb9","slug":"twitter-tweet-retweets-lookup-1b19975b","name":"Twitter Tweet Retweets Lookup","description":"Get the users who retweeted a specific tweet.","url":"https://x402.apidirect.io/v1/twitter/tweet/retweets?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["tweet_id"],"properties":{"pages":{"type":"integer","default":1,"maximum":20,"minimum":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."},"tweet_id":{"type":"string","pattern":"^[0-9]+$","description":"Numeric tweet ID"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Gyc9axUNOsOevxtGtyGdp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the list of users who retweeted a specific tweet by its numeric tweet ID.","exampleAgentPrompt":"Who retweeted tweet ID 1234567890123456789? Fetch up to 3 pages of retweeters.","exampleUseCases":[{"title":"Viral tweet audience analysis","prompt":"Can you pull all the users who retweeted tweet 1823945612398745600? I want to see who's been sharing it — get me up to 5 pages of retweeters."},{"title":"Brand mention tracking","prompt":"Find everyone who retweeted our product launch tweet — the tweet ID is 1798234561029384756. Fetch the first 2 pages so I can see who amplified it."},{"title":"Influencer engagement audit","prompt":"I need to know which accounts retweeted tweet ID 1756432198047362048. Give me 1 page of results so I can check if any major accounts picked it up."}],"resultDescription":"Returns a paginated list of Twitter/X user objects who retweeted the specified tweet, including profile details such as usernames, display names, follower counts, and profile metadata. Multiple pages can be requested and are merged into a single response, with early stopping when no more results are available.","failureModes":["Invalid or non-numeric tweet_id returns a validation error","Tweet does not exist or has been deleted returns empty or error response","Tweet is from a private/protected account and retweet data is inaccessible","Requesting more than 20 pages returns a schema validation error","Rate limiting or downstream Twitter API restrictions may return partial results","Payment failure (402) if USDC balance is insufficient — billed per page fetched"],"whenToPreferThis":"Use this endpoint when you need to identify which Twitter/X users retweeted a specific tweet, especially for audience analysis, virality tracking, or influencer engagement audits. It supports multi-page fetching (up to 20 pages) merged into a single response, making it suitable for high-retweet-count posts. Prefer this over manual scraping or Twitter's native API if you need quick programmatic access without OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:00.461Z","isFirstParty":false,"canonicalSlug":"twitter-tweet-retweets-lookup-1b19975b"}