{"uid":"cap_SId7BpjawspSs4wlwv9xs","slug":"api-direct-get-quote-tweets-for-a-tweet-3ad9f2f5","name":"API Direct – Get Quote Tweets for a Tweet","description":"Get the quote tweets for a specific tweet.","url":"https://x402.apidirect.io/v1/twitter/tweet/quotes?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"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each quote tweet. 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"}}}},"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_xam9SUtf5dX0lQXw__0DA","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 all quote tweets for a specific tweet by numeric tweet ID, with optional AI sentiment analysis on each quote.","exampleAgentPrompt":"Can you pull all the quote tweets for tweet ID 1234567890123456789 and include the sentiment analysis so I can see how people are emotionally reacting to it?","exampleUseCases":[{"title":"Viral tweet reaction monitoring","prompt":"Fetch the quote tweets for tweet ID 1876543210987654321 — I want to see what people are saying about it and get the sentiment breakdown so I can understand the emotional reaction."},{"title":"Brand mention sentiment analysis","prompt":"Get the quotes on tweet 1765432109876543210 and turn on the sentiment analysis — I need to know the dominant emotion and whether the overall polarity is positive, negative, or neutral."},{"title":"Research on public discourse","prompt":"Pull up to 5 pages of quote tweets for tweet ID 1654321098765432100 so I can study how the conversation is spreading and what the key responses are."}],"resultDescription":"Returns a paginated, merged list of quote tweets for the specified tweet. Each quote tweet includes the tweet text, author details, engagement metrics, and optionally a sentiment object with scores for eight emotions (joy, trust, fear, surprise, sadness, disgust, anger, anticipation), a dominant emotion, emotional intensity (0–10), and polarity (positive, negative, or neutral).","failureModes":["Invalid or non-numeric tweet_id returns a validation error","Tweet does not exist or has been deleted returns empty or error response","Private or suspended account tweets may return no results","pages parameter out of range (below 1 or above 20) returns validation error","Insufficient USDC balance causes payment failure and no results returned","Rate limiting by the upstream Twitter/X API may return partial results"],"whenToPreferThis":"Use this endpoint when you need to retrieve the quote tweets for a specific known tweet, especially when you also want AI-powered emotion and sentiment analysis on each quote. It is the right choice for social listening, brand monitoring, public discourse research, or any scenario where understanding how users are re-contextualizing a tweet is important. Prefer it over a keyword search endpoint when you have a specific tweet ID and want structured quote data rather than broad keyword results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:55.347Z","isFirstParty":false,"canonicalSlug":"api-direct-get-quote-tweets-for-a-tweet-3ad9f2f5"}