{"uid":"cap_MOkWt6Zs1XCP31_8vf5uz","slug":"x402-twit-sh-306c24f5","name":"x402.twit.sh - Get User Timeline Tweets","description":"Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/tweets/user?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"],"type":"string"},"queryParams":{"type":"object","required":["username"],"properties":{"username":{"type":"string","description":"Twitter screen name (without @)"},"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":"1110302988","text":"Running bitcoin","author":{"id":"9253672","name":"Hal Finney","username":"halfin"},"created_at":"2009-01-11T03:39:18.000Z","public_metrics":{"like_count":134000,"quote_count":3500,"reply_count":5400,"retweet_count":32000}}],"meta":{"next_token":"abc123"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"username":"nasa"}}},"response":{"_truncated":true,"_originalSize":46567}},"exampleRequest":{"username":"nasa"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_UcsjWe6nxtfgWY8OH0s0a","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":"Fetches the most recent tweets from a specific Twitter/X user's timeline by their screen name, with pagination support.","exampleAgentPrompt":"Can you pull the latest tweets from @naval's Twitter timeline — show me the most recent posts?","exampleUseCases":null,"resultDescription":"Returns an X v2 API-compatible JSON object containing up to 20 of the user's most recent tweets sorted by newest first, including tweet text, IDs, timestamps, and a next_token cursor for paginating to older tweets.","failureModes":["Username not found — returns 404 or empty result if the screen name doesn't exist","Private/protected account — tweets not accessible, returns error or empty data","Rate limiting or payment failure — returns 402 or 429 if quota exceeded","Invalid pagination token — returns error if next_token is malformed or expired","Missing required username parameter — returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to read the recent tweet history of a known Twitter/X user by their screen name. Prefer this over search endpoints when you want a specific user's own posts rather than tweets about a topic. Ideal for monitoring a specific account's activity, summarizing what someone has been saying, or paginating through their recent history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-04T18:19:03.010Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:32:03.250Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-306c24f5"}