{"uid":"cap_GiPrMV4r3q1Q5pFmGl8ld","slug":"agentutility-twitter-user-timeline-tweets-user-e1f917f4","name":"AgentUtility Twitter User Timeline (tweets-user)","description":"Returns recent public tweets by username, using the same read-only X API v2 user_tweets backend as user-tweets. Exposed under the buyer wording used by /tweets/user-style clients. Use it as a tweets-by-username or Twitter user timeline API.","url":"https://x402.agentutility.ai/tweets-user","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["username"],"properties":{"mode":{"enum":["user_tweets"],"type":"string","description":"Optional. Operation mode; defaults to 'user_tweets' for this endpoint. Accepts search, user, tweets, users, or user_tweets."},"username":{"type":"string","description":"X/Twitter handle, with or without @."},"max_results":{"type":"number","description":"Number of recent posts to fetch. Clamped to 5-50."},"include_retweets":{"type":"boolean","description":"Include retweets when true. Defaults false."},"pagination_token":{"type":"string","description":"Optional X pagination token."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"source":{"type":"string"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"user_tweets","source":"X API v2 user tweets timeline","result_count":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_tNbiy8CyGnqcMEG3oRR6p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the recent tweet timeline for a specified Twitter/X username using the X API v2 user_tweets endpoint.","exampleAgentPrompt":"Can you pull the last 20 tweets from @elonmusk's Twitter timeline and show me what he's been posting about recently?","exampleUseCases":[{"title":"Competitor social media monitoring","prompt":"Grab the most recent 25 tweets from @OpenAI's Twitter account so I can see what they've been announcing lately."},{"title":"Research influencer tweet history","prompt":"Fetch the last 50 tweets from @naval on Twitter — I want to see his recent takes and threads."},{"title":"Track brand activity on X","prompt":"Pull the latest tweets from @Nike's Twitter account and summarize what they've been posting this week."}],"resultDescription":"Returns a list of recent tweets from the specified user's timeline, including tweet text, tweet IDs, creation timestamps, and potentially engagement metrics (likes, retweets). Data comes from the X API v2 user_tweets endpoint and reflects the user's public posts.","failureModes":["Invalid or non-existent username returns an error or empty result","Private/protected Twitter accounts return no tweets","X API rate limits may cause throttling or 429 errors","Suspended accounts return an error response","Network or upstream X API downtime causes failures","Insufficient USDC balance causes payment failure via x402 protocol"],"whenToPreferThis":"Use this endpoint when you need to programmatically fetch a Twitter user's public tweet timeline by username, especially within an agentic workflow that handles micropayments via the x402/USDC protocol. Prefer this over scraping or manual lookup when you need structured tweet data at low cost ($0.01 per call) without managing your own X API credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:19.655Z","isFirstParty":false}