{"uid":"cap_iQycCWjWZSDQaUSO5tP5I","slug":"readx-list-timeline-7321f5a3","name":"ReadX List Timeline","description":"The combined timeline of every account in a list. Example: GET /api/lists/1/timeline","url":"https://readx.sh/api/lists/:id/timeline","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":["id"],"properties":{"id":{"type":"string","pattern":"^[0-9]+$","description":"Numeric resource id."},"cursor":{"type":"string","description":"Pagination cursor from a previous response's pagination.bottom (or replies.bottom)."}}}},"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_vhSJUO2sfwaUEaSVHIcHG","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":"Retrieves the combined tweet timeline for all accounts in a specified X/Twitter list, with pagination support","exampleAgentPrompt":"Fetch the latest tweets from X list ID 1583921 — and if there's a pagination cursor from last time, use it to get the next page of results.","exampleUseCases":null,"resultDescription":"A combined chronological tweet timeline containing posts from all accounts in the specified X list, including tweet text, author details, timestamps, engagement metrics, and a pagination cursor for fetching subsequent pages.","failureModes":["Invalid list ID (non-numeric) returns a 400 or validation error","List not found or private list returns a 404 or access denied error","Missing required id parameter causes request rejection","Invalid or expired pagination cursor returns an error or resets to first page","Payment failure (x402) returns 402 Payment Required","Rate limiting or upstream X API issues may cause 429 or 503 responses"],"whenToPreferThis":"Use this endpoint when you need to read the aggregated tweet feed of a curated X/Twitter list, especially for monitoring multiple accounts simultaneously. Prefer this over individual user timeline endpoints when you have a pre-curated list of accounts and want a single merged feed. Ideal for news monitoring, tracking industry voices, or following a topic through a managed list.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:54.731Z","isFirstParty":false}