{"uid":"cap_ckTsFyJnMgFBxyiEY6jYK","slug":"agentutility-user-tweets-api-4333e158","name":"AgentUtility User Tweets API","description":"Fetches the latest public tweets from any X username, with text, timestamps, metrics, pagination token, and author profile. Read-only X API v2 route: resolves a public username, fetches that user's recent public posts, and excludes retweets by default. No posting, replying, liking, following, DM access, or account mutation. Use it as a user tweets API, X user timeline, or Twitter user posts endpoint.","url":"https://x402.agentutility.ai/user-tweets","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":"Use 'user_tweets' for public timeline lookup."},"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. Default 10."},"include_retweets":{"type":"boolean","description":"Include retweets when true. Defaults false."},"pagination_token":{"type":"string","description":"Optional X pagination token for the next page."}}},"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"},"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"object","properties":{"username":{"type":"string"}}}}}},"username":{"type":"string"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"user_tweets","source":"X API v2 user tweets timeline","tweets":[{"id":"123","text":"x402 payments are live","author":{"username":"bankrbot"}}],"username":"bankrbot","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_08Eh0ao37A0Zp-9eb4HY9","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 latest public tweets from a specified X (Twitter) username, including text, timestamps, engagement metrics, pagination token, and author profile data.","exampleAgentPrompt":"Pull the 10 most recent public tweets from the X account @elonmusk — I want the tweet text, timestamps, and engagement metrics like likes and retweets.","exampleUseCases":[{"title":"Competitive brand monitoring","prompt":"Grab the last 20 tweets from @OpenAI's X account, including timestamps and public metrics — I want to see what they've been announcing lately."},{"title":"Influencer research for campaign","prompt":"Fetch the most recent 15 posts from @sama on X with their like and retweet counts so I can see what topics he's engaging his audience with."},{"title":"Journalist source verification","prompt":"Pull the latest tweets from @Reuters on X — show me the text and when each was posted so I can verify what they've officially reported in the past week."}],"resultDescription":"Returns a list of recent public tweets for the specified X username. Each tweet includes the tweet text, creation timestamp, public engagement metrics (likes, retweets, replies, impressions), and a pagination token for fetching additional results. Also includes expanded author profile data such as display name, handle, and profile description. Retweets are excluded by default.","failureModes":["Username not found or account does not exist — returns user resolution error","Account is private/protected — returns access denied or empty results","X API v2 rate limits exceeded — returns rate limit error","Invalid or expired pagination token — returns pagination error","X API service downtime — returns upstream error","Payment failure or insufficient USDC balance — returns payment required error"],"whenToPreferThis":"Choose this endpoint when you need to retrieve the recent post history of a specific known X user by username, including rich engagement metrics and author profile data. It is ideal for monitoring individual accounts, researching influencers, tracking brand communications, or building timelines. Prefer this over the search endpoint when you already know the specific account you want to pull from rather than searching across all public tweets by keyword or topic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:19.289Z","isFirstParty":false}