{"uid":"cap_FsRaHTWe-a9q6Gt2dB8Eq","slug":"readx-x-twitter-user-timeline-with-replies-13229223","name":"ReadX — X/Twitter User Timeline with Replies","description":"A user's timeline including their replies. Example: GET /api/jack/with_replies","url":"https://readx.sh/api/:name/with_replies","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9_]+$","minLength":1,"description":"X handle without the leading @ (alphanumeric and underscore)."},"cursor":{"type":"string","description":"Pagination cursor from a previous response's pagination.next_cursor (the conversation endpoint at /api/{name}/tweets/{id} instead takes its own nested reply cursor — see that endpoint)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_ORTqbR3mmb5CbOziBN97B","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 a paginated timeline of a Twitter/X user's tweets, retweets, quotes, AND replies by username.","exampleAgentPrompt":"Can you pull the full timeline for the X account 'elonmusk' — including all their replies, not just top-level tweets — and give me the latest page of posts?","exampleUseCases":null,"resultDescription":"A JSON object containing a paginated list of the user's tweets, retweets, quotes, and replies, along with pagination cursors (top and bottom) to fetch additional pages using the cursor parameter.","failureModes":["Invalid or non-existent X handle returns an error or empty result","Handle contains invalid characters (not matching ^[A-Za-z0-9_]+$) causes a 400/validation error","Expired or invalid pagination cursor results in an error or restarted pagination","Account is private or suspended, returning no data or an access error","Rate limiting or payment failure (x402 payment not processed) blocks the request"],"whenToPreferThis":"Use this endpoint when you need a user's complete posting history including their replies to other tweets — not just their original posts. Prefer this over the base timeline endpoint when conversational context and reply activity matter. It is ideal for monitoring engagement, understanding discourse participation, or building a full picture of a user's X presence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:49.240Z","isFirstParty":false}