{"uid":"cap_RM68OsaR_B7i-A4BGsFMu","slug":"payweave-twitter-list-tweets-0a9c7d32","name":"PayWeave Twitter – List Tweets","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/lists/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","bodyType","body"],"properties":{"body":{"anyOf":[{"not":{}},{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^\\d+$","description":"Numeric ID, e.g. 1693573582226665701"},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{"tweets":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of tweet objects."},"next_cursor":{"type":"string","description":"Cursor to pass as `next_token` for the next page."},"has_next_page":{"type":"boolean","description":"True when more pages are available."}},"description":"Tweet list JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SAlaHggAA1gO3Uq35nop1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a paginated list of tweets belonging to a specific Twitter/X list by its numeric list ID.","exampleAgentPrompt":"Pull the tweets from Twitter list 1693573582226665701 — grab the first page of results.","exampleUseCases":[{"title":"Monitor curated tech news list","prompt":"Fetch the latest tweets from my curated tech news Twitter list with ID 1693573582226665701 so I can see what's trending today."},{"title":"Paginate through a political commentary list","prompt":"Get the next page of tweets from Twitter list 84839422 — the pagination cursor from the last call was 'abc123nexttoken'."},{"title":"Aggregate tweets for newsletter digest","prompt":"Retrieve all the tweets from Twitter list 9987654321 so I can compile them into this week's newsletter digest."}],"resultDescription":"Returns a JSON object containing an array of tweet objects (with full tweet metadata as provided verbatim by twitterapi.io), a next_cursor string for fetching the next page, and a has_next_page boolean indicating whether additional results exist.","failureModes":["Invalid or non-numeric list ID returns an error or empty result","List is private or deleted — API returns an access error","Invalid next_token cursor causes a pagination error or resets to first page","Rate limits or payment failures return 402 or 429 status codes","Empty tweets array if the list has no tweets"],"whenToPreferThis":"Use this endpoint when you need to retrieve tweets scoped to a specific Twitter/X list (by its numeric ID), especially when paginating through a curated set of accounts' posts. Prefer this over general tweet search endpoints when the use case is list-based monitoring, digest creation, or aggregation from a predefined group of Twitter accounts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:36:15.895Z","isFirstParty":false}