{"uid":"cap_TpsRvciBsKf9UPgS-5vvM","slug":"twitter-x-list-tweets-597e6ab5","name":"Twitter/X List Tweets","description":"Get posts from a public X list.","url":"https://twitter.use.x402atlas.com/list-tweets","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":["list_id"],"properties":{"list_id":{"type":"string","pattern":"^[0-9]{1,25}$","maxLength":25,"description":"Decimal X list identifier"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data","result_count"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"cursor":{"type":"string","description":"Opaque cursor for the next page, when supplied by X"},"queried_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"user":{"name":"Bill Gates","id_str":"50393960","screen_name":"BillGates"},"id_str":"1903602810652082591","full_text":"Example X post","created_at":"Sun Mar 23 12:00:00 +0000 2025","reply_count":8,"retweet_count":15,"favorite_count":120}],"cursor":"NEXT_PAGE_CURSOR","queried_at":"2026-07-26T12:00:00Z","result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6mi_UMTAsQxEceYdC07Zi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the recent posts from a specified public X (Twitter) list by its numeric list ID.","exampleAgentPrompt":"Pull the latest tweets from the public X list with ID 84839422 and show me what's been posted.","exampleUseCases":[{"title":"Monitor a curated news list","prompt":"Fetch the latest posts from the X list 1234567890 — it's a curated list of tech journalists and I want to see what stories they're covering today."},{"title":"Aggregate competitor social content","prompt":"Pull all recent tweets from the public Twitter list 9876543210 so I can see what content our competitors are sharing this week."},{"title":"Track a community list feed","prompt":"Get me the latest posts from X list 112233445566 — it's a list of AI researchers and I want to see what they've been discussing lately."}],"resultDescription":"Returns a JSON object containing an array of tweet objects (each with full post data), the total result count, the UTC timestamp when the query was made, and an optional opaque cursor string for fetching the next page of results when more tweets are available.","failureModes":["Invalid or non-numeric list_id returns a validation error","Private or deleted list returns an access error or empty result","List ID that doesn't exist returns a not-found error","X API rate limits may cause temporary failures","Missing required list_id parameter returns a 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to retrieve tweets from a specific curated X list by its numeric ID, rather than searching by keyword or pulling a single user's timeline. Ideal for monitoring aggregated feeds of multiple accounts organized into a list, or for regularly polling a curated group of sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:53.360Z","isFirstParty":false}