{"uid":"cap_DmnuIOg_vLpo4NlMzMgip","slug":"payweave-twitter-user-tweets-timeline-2abcffc1","name":"PayWeave Twitter – User Tweets Timeline","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/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","properties":{"userId":{"type":"string","pattern":"^\\d+$","description":"Numeric user ID. Preferred over username when known."},"username":{"type":"string","minLength":1,"description":"X handle / screen name (without @)."},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."},"include_replies":{"type":"boolean","description":"Include replies in the timeline. Defaults to false."}},"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_hlIZ3IWZozrXKhngwVUsd","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":"Retrieves a paginated timeline of tweets posted by a specific X/Twitter user, identified by user ID or username.","exampleAgentPrompt":"Pull the latest tweets from the X account @NASA — include replies too, and if there are multiple pages just grab the first one.","exampleUseCases":[{"title":"Monitoring a brand's Twitter activity","prompt":"Fetch the most recent tweets from @Tesla's Twitter account so I can see what they've been posting this week — no replies needed, just their original posts."},{"title":"Paginating through an influencer's tweet history","prompt":"Get the next page of tweets from user ID 44196397 using cursor 'abc123xyz' — I'm working through their full timeline."},{"title":"Researching a public figure's recent statements","prompt":"Show me the latest tweets from @BernieSanders, including any replies he's posted, so I can see his recent public statements."}],"resultDescription":"Returns a JSON object containing an array of tweet objects (each with full tweet data forwarded verbatim from twitterapi.io), a next_cursor string for fetching the next page, and a has_next_page boolean indicating whether additional pages exist.","failureModes":["Invalid or non-numeric userId causes a validation error","Unknown username returns an empty tweets array or 404-style error","Missing both userId and username results in a request validation failure","Expired or invalid next_token causes pagination to fail","Rate limits or upstream twitterapi.io outages return a service error","Private/suspended accounts return no tweets"],"whenToPreferThis":"Use this endpoint when you need a user's tweet timeline by their handle or numeric ID, especially with pagination support. Prefer this over search-based endpoints when you know the specific account and want their chronological posts rather than keyword-matched results. The pay-per-call x402 model suits agents that need occasional lookups without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:30.567Z","isFirstParty":false}