{"uid":"cap_HtI5bkNVmBK6T6BZMsdiu","slug":"twitr-sh-x-twitter-list-reader-615cd07c","name":"twitr.sh X/Twitter List Reader","description":"Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers. Billed per item returned. Useful for following a curated set of accounts as one feed.","url":"https://twitr.sh/api/tools/x_lists","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","description":"List ID."},"kind":{"enum":["tweets","members","followers"],"type":"string","description":"What to read from the list."},"sinceTime":{"type":"string"},"untilTime":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"MANDATORY: max items returned, billed per item."},"includeReplies":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"items":[{"id":"1893710452812718080","text":"This is a great thread, thanks for sharing.","createdAt":"2026-02-24T10:05:00.000Z","likeCount":1180,"authorUsername":"elonmusk"}],"runId":"tw_example","payment":{"amount":"0.120000","currency":"USD","protocol":"x402"},"duration":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.024","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.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mgwMGGYKzmNnd2It5kwKK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads an X/Twitter List's tweet timeline, member roster, or follower list, returning up to a specified number of items billed per result.","exampleAgentPrompt":"Pull the latest 50 tweets from Twitter list ID 1234567890, including replies, so I can see what the accounts in that curated list have been posting.","exampleUseCases":[{"title":"Monitor a curated tech influencer feed","prompt":"Fetch the last 100 tweets from Twitter list 84839422 — I want to see everything that group of tech accounts posted this week, including their replies."},{"title":"Audit members of an industry list","prompt":"Give me the full member roster of X list ID 9876543210, up to 200 members — I want to see which accounts are on that fintech thought leaders list."},{"title":"Track followers of a news curation list","prompt":"Who are the followers of Twitter list 1122334455? Return up to 500 followers so I can understand the audience for that AI news list."}],"resultDescription":"An array of items matching the requested kind: for 'tweets', tweet objects with content, author, timestamp, engagement metrics and reply metadata; for 'members' or 'followers', user profile objects with handle, display name, bio, follower count, and verification status. The number of items is capped at resultsLimit and billed per item returned.","failureModes":["Invalid or non-existent List ID returns a 404-style error","List is private or restricted and the caller lacks access, returning an authorization error","resultsLimit not provided (mandatory field) causes request rejection","sinceTime/untilTime in wrong format causes parsing failure","Rate limits or quota exhaustion on the underlying Twitter API returning a 429 or service error","Billing failure if USDC balance is insufficient for the requested resultsLimit"],"whenToPreferThis":"Choose this endpoint when you need to aggregate content or members from a pre-curated X/Twitter List rather than searching broadly or fetching a single user's timeline. It is ideal for monitoring a defined group of accounts as one unified feed, auditing list membership, or understanding a list's follower base. Prefer it over the search endpoint when the set of accounts is already defined as a Twitter List, and over the user timeline endpoint when you need multi-account aggregation in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:12.428Z","isFirstParty":false}