{"uid":"cap_14-2Ywc2uTrbGJHiL42Xt","slug":"twit-sh-retweeted-by-80f07726","name":"twit.sh Retweeted By","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/tweets/retweeted_by","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":["id"],"properties":{"id":{"type":"string","description":"Numeric tweet ID"},"next_token":{"type":"string","description":"Pagination cursor from previous response"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}}],"meta":{"next_token":"abc123"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8PvtIRSDRd7tKuemWp5Jc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of Twitter/X users who have retweeted a specific tweet, identified by numeric tweet ID.","exampleAgentPrompt":"Who retweeted tweet ID 1234567890? Give me the full list of users with their follower counts.","exampleUseCases":[{"title":"Influencer audience analysis","prompt":"Can you pull the list of everyone who retweeted tweet 1778234567890123456 and tell me their follower counts? I want to see if any big accounts amplified it."},{"title":"Viral post origin tracking","prompt":"This tweet ID 1801234567890123456 seems to be going viral — can you fetch all the users who retweeted it so I can figure out which communities are spreading it?"},{"title":"Competitor campaign monitoring","prompt":"I want to know who retweeted our competitor's product launch tweet, ID 1793456789012345678. Grab the full retweeter list with their bios and follower counts."}],"resultDescription":"A JSON array of user objects for each account that retweeted the specified tweet. Each object includes the user's numeric ID, username, display name, verified status, bio description, and public metrics (followers count, following count, tweet count, like count). A meta object with a next_token is included when more pages of results are available.","failureModes":["Invalid or non-numeric tweet ID returns an error response","Tweet ID not found or deleted returns empty data array","Payment failure (insufficient USDC balance) returns HTTP 402 and no data","Rate limiting or upstream Twitter/X API errors may cause transient failures","next_token from a different endpoint or expired token causes pagination errors"],"whenToPreferThis":"Use this endpoint when you need to identify the specific users who retweeted a given tweet — for audience analysis, influencer discovery, campaign monitoring, or community mapping. It is preferable to scraping or manual lookup because it returns structured user profile data including follower metrics, requires no API key registration, and is payable autonomously per-request via USDC on Base. Choose this over search-based endpoints when you have a known tweet ID and want the retweet audience rather than the tweet content itself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:16.538Z","isFirstParty":false}