{"uid":"cap_zYpFm4SBHRaOgQjT5ks13","slug":"x402-x-twitter-list-timeline-api-bf9ffdad","name":"X402 X/Twitter List Timeline API","description":"ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search & lists — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.","url":"https://x.1x402.sh/api/lists/%7Bid%7D/timeline?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_b_cD1A1yNYAdaNfShLUIa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the tweet timeline for a specific X/Twitter list by list ID, paid via x402 micropayment at $0.05 USDC per call","exampleAgentPrompt":"Can you pull the latest tweets from Twitter list ID 1234567890 — I want to see what's been posted there recently without needing a Twitter API key?","exampleUseCases":[{"title":"Monitor industry news from curated lists","prompt":"Can you check my tech news Twitter list and show me the latest posts? I want to keep up with what industry experts are sharing without setting up API credentials."},{"title":"Track competitor activity in real-time","prompt":"Pull the most recent tweets from my competitors list on X — I need to see what they're announcing and how people are reacting to their posts."},{"title":"Aggregate curated content for team briefings","prompt":"Fetch all the new tweets from my business intelligence list and give me a summary of what the thought leaders are talking about this week."}],"resultDescription":"Returns a JSON object with a status code and a data payload containing the list's tweet timeline — recent tweets from all accounts included in the specified X/Twitter list, including tweet content, metadata, and author information.","failureModes":["Invalid or non-existent list ID returns an error in the JSON response","Payment failure via x402 results in HTTP 402 and no data returned","Private or restricted lists may return empty data or access denied","Malformed list ID parameter results in a bad request error","Rate limiting or upstream X API errors may cause intermittent failures"],"whenToPreferThis":"Choose this endpoint when you need to retrieve tweets from a specific X/Twitter list without setting up Twitter API credentials or developer accounts. Ideal for agents that need lightweight, pay-per-call access to Twitter list timelines using USDC micropayments on Base via the x402 protocol. Best when cost per call matters more than bulk throughput.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T01:25:49.876Z","isFirstParty":false,"canonicalSlug":"x402-x-twitter-list-timeline-api-bf9ffdad"}