{"uid":"cap_vgWjtXeULF60SglMcIvs9","slug":"www-surplusintelligence-ai-0c5842dd","name":"X/Twitter User Timeline Lookup via Surplus Intelligence","description":"X/Twitter API v2 via Surplus Intelligence: User timeline (10 units)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/users/:userId/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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["userId"],"properties":{"userId":{"type":"string","description":"Numeric X/Twitter user ID."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"max_results":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of results to return."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{},"meta":{"type":"object"},"errors":{"type":"array"}},"additionalProperties":true}}}}},"responseSchema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","text","edit_history_tweet_ids"],"properties":{"id":{"type":"string"},"text":{"type":"string"},"edit_history_tweet_ids":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","required":["newest_id","oldest_id","next_token","result_count"],"properties":{"newest_id":{"type":"string"},"oldest_id":{"type":"string"},"next_token":{"type":"string"},"result_count":{"type":"number"}}}}},"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"userId":"44196397"},"queryParams":{"max_results":20}}},"response":{"data":[{"id":"2067460143139237988","text":"RT @JDVance: Doctors and hospitals used junk science from WPATH to justify selling gender transition procedures to kids and their parents.…","edit_history_tweet_ids":["2067460143139237988"]},{"id":"2067456232076509562","text":"RT @cb_doge: BREAKING: California Birth Rate Falls Below Replacement Level\n\n• California’s fertility rate hit a record low\n• It fell from 2…","edit_history_tweet_ids":["2067456232076509562"]},{"id":"2067438979667140620","text":"https://t.co/ujL9EUqFK4","edit_history_tweet_ids":["2067438979667140620"]},{"id":"2067438575487234313","text":"@nayibbukele ❤️","edit_history_tweet_ids":["2067438575487234313"]},{"id":"2067438023894253721","text":"RT @XFreeze: Grok Build just got new update with new improvements, features, and bug fixes\n\nRelease Notes: v0.2.55\n\nFeatures:\n• Added optio…","edit_history_tweet_ids":["2067438023894253721"]},{"id":"2067436677019422914","text":"RT @cursor_ai: It’s now easier to move local agents to the cloud so they can keep working with your laptop closed.\n\nPrompt Cursor from your…","edit_history_tweet_ids":["2067436677019422914"]},{"id":"2067432573836652699","text":"Progress https://t.co/6FGBIzqBOU","edit_history_tweet_ids":["2067432573836652699"]},{"id":"2067431278006391066","text":"As it should. https://t.co/jg2qmvptSW","edit_history_tweet_ids":["2067431278006391066"]},{"id":"2067431040940167408","text":"RT @travelingflying: Elon Musk: ”I think there are great things in every culture. We don’t want the German culture to disappear. We don’t w…","edit_history_tweet_ids":["2067431040940167408"]},{"id":"2067430722399539385","text":"@KHdimples @wholemars @Tesla_AI This functionality will be there in about 3 months or so","edit_history_tweet_ids":["2067430722399539385"]},{"id":"2067428856441815357","text":"@teortaxesTex Probably Q1","edit_history_tweet_ids":["2067428856441815357"]},{"id":"2067427059895521345","text":"@midjourney Cool","edit_history_tweet_ids":["2067427059895521345"]},{"id":"2067427013527580863","text":"Essential reading https://t.co/Zvh5CpgeQf","edit_history_tweet_ids":["2067427013527580863"]},{"id":"2067426896414208365","text":"And this report is just the tip of an enormous iceberg of evil https://t.co/jT2SdRWqkv","edit_history_tweet_ids":["2067426896414208365"]},{"id":"2067426405391237170","text":"RT @karaebel: Behind the scenes: many other cool shots from the 1.5 video launch. \n\nExploring styles in Grok Imagine. https://t.co/huuCM8bP…","edit_history_tweet_ids":["2067426405391237170"]},{"id":"2067426268984009187","text":"Utterly irreconcilable with Western values https://t.co/Z8aoALGfmn","edit_history_tweet_ids":["2067426268984009187"]},{"id":"2067424406247485777","text":"No one can save you when they become the police https://t.co/AqnHGaxCCI","edit_history_tweet_ids":["2067424406247485777"]},{"id":"2067423209176301669","text":"@JjinUk64 @RiceIam22 @MKnowlesShow @officialsammyuk Important context","edit_history_tweet_ids":["2067423209176301669"]},{"id":"2067422867801952274","text":"@agupta @garrytan Exactly 😂","edit_history_tweet_ids":["2067422867801952274"]},{"id":"2067422433251078480","text":"Maybe WSJ isn’t that bad after all 😂 https://t.co/4Jc3JytFdB","edit_history_tweet_ids":["2067422433251078480"]}],"meta":{"newest_id":"2067460143139237988","oldest_id":"2067422433251078480","next_token":"7140dibdnow9c7btwoxij8e7r4w22rg1elj7sx5eibr5c","result_count":20}}},"exampleRequest":{"max_results":20},"tags":["x402"],"displayCostAmount":"0.101000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.101000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.052","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.052","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iOFsL_rNSuv_0r-x1-sAk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.052","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the recent tweet timeline for a specific X/Twitter user by their numeric user ID, returning up to 100 tweets per call","exampleAgentPrompt":"Pull the last 20 tweets from Twitter user ID 44196397 so I can see what they've been posting recently.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 'data' array of tweet objects for the specified user, plus a 'meta' object containing pagination info such as result counts and next/previous tokens. May also include an 'errors' array if partial results or issues occur.","failureModes":["Invalid or non-numeric userId returns an error from the Twitter API","User account is suspended, private, or deleted — returns empty data or error","max_results out of range (< 1 or > 100) causes a validation error","Insufficient payment or expired x402 credentials result in a 402 payment error","Rate limit exceeded on the underlying Twitter API returns a 429-like error","User has no tweets — returns empty data array with meta"],"whenToPreferThis":"Use this endpoint when you need the tweet timeline of a known user by their numeric Twitter/X user ID, especially in automated or agentic workflows that need to pay per-call via USDC without managing Twitter API credentials directly. Prefer this over direct Twitter API access when you want micro-payment billing or don't have your own Twitter developer account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:23.375Z","isFirstParty":false}