{"uid":"cap_Dua0RogRS55uYoy5-wllV","slug":"api-direct-get-twitter-x-user-tweets-83607039","name":"API Direct - Get Twitter/X User Tweets","description":"Get tweets posted by a specific Twitter/X user.","url":"https://x402.apidirect.io/v1/twitter/user/tweets?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":["username"],"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."},"username":{"type":"string","maxLength":50,"description":"Twitter username without the @ symbol (max 50 characters). A leading @ is accepted and stripped."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each 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 tweet"}}}},"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_Ofvnay-z4DiquNvo8cgV1","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 tweets posted by a specific Twitter/X user by username, with optional AI sentiment analysis per tweet.","exampleAgentPrompt":"Pull the last 3 pages of tweets from the Twitter account @elonmusk and include sentiment analysis on each tweet so I can see the emotional tone.","exampleUseCases":[{"title":"Brand monitoring on Twitter","prompt":"Fetch the last 2 pages of tweets from the Twitter account @Nike and include sentiment scores so I can see whether their recent posts are coming across as positive or negative."},{"title":"Competitor social media tracking","prompt":"Get me the 5 most recent pages of tweets from @OpenAI's Twitter account — I want to track what they've been announcing lately."},{"title":"Influencer content analysis","prompt":"Grab 1 page of tweets from Twitter user MrBeast and run sentiment analysis on each one — I want to understand the emotional intensity and dominant emotions in his posts."}],"resultDescription":"Returns a merged list of tweets from the specified user across the requested number of pages. Each tweet includes standard tweet data (text, timestamp, engagement metrics, etc.). When sentiment analysis is enabled, each tweet also includes a sentiment object with eight emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each scored 0-100), a dominant emotion, an emotional intensity score (0-10), and a polarity label (positive, negative, or neutral).","failureModes":["Invalid or non-existent username returns an error or empty result","Username with leading @ is stripped automatically but malformed inputs may fail","Requesting more than 20 pages is rejected by schema validation","Private or suspended Twitter accounts may return no results","Rate limits or Twitter API downtime may cause upstream failures","Sentiment analysis may be unavailable for very short or non-textual tweets"],"whenToPreferThis":"Choose this endpoint when you need to retrieve the public tweet history of a specific known Twitter/X user by username, especially when you also want AI-powered sentiment and emotion analysis per tweet. It supports pagination up to 20 pages and merges results into a single response, making it ideal for bulk collection. Prefer this over general Twitter search endpoints when you know the exact account and want their timeline rather than keyword-based results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:10.542Z","isFirstParty":false,"canonicalSlug":"api-direct-get-twitter-x-user-tweets-83607039"}