{"uid":"cap_BLAIpw96dg2m4n6C-H40n","slug":"www-surplusintelligence-ai-db199a83","name":"X/Twitter Following Lookup via Surplus Intelligence","description":"X/Twitter API v2 via Surplus Intelligence: Followers/following (100 units)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/users/:userId/following","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","name","username"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"}}}},"meta":{"type":"object","required":["next_token","result_count"],"properties":{"next_token":{"type":"string"},"result_count":{"type":"number"}}}}},"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"userId":"44196397"},"queryParams":{"max_results":50}}},"response":{"data":[{"id":"3108351","name":"The Wall Street Journal","username":"WSJ"},{"id":"906438260","name":"Department of War CTO","username":"DoWCTO"},{"id":"19069018","name":"Julian Reichelt","username":"jreichelt"},{"id":"249353968","name":"Jay Baxter","username":"jaybaxter"},{"id":"1394449160","name":"Boris Skorobogaty","username":"theskory"},{"id":"1667903437139238913","name":"Heavy Pulp","username":"heavypulp"},{"id":"845021022","name":"John Federspiel","username":"johnfederspiel"},{"id":"1745892418539417600","name":"elie","username":"eliebakouch"},{"id":"19058681","name":"ashton kutcher","username":"aplusk"},{"id":"1472698895553773568","name":"Lynn Martin","username":"lynnmartin"},{"id":"16106584","name":"Ian Miles Cheong","username":"ianmiles"},{"id":"1674187388825006082","name":"the tiny corp","username":"__tinygrad__"},{"id":"23275456","name":"Matthew Prince 🌥","username":"eastdakota"},{"id":"2045311478916333568","name":"Daniel Dueri","username":"ddueri0"},{"id":"1900557217129975808","name":"Sean Parnell","username":"SeanParnellASW"},{"id":"1291801117966336002","name":"RobertIsom","username":"RobertIsom_"},{"id":"416761602","name":"Jon Shulkin","username":"jon"},{"id":"119454938","name":"Duncan Penn","username":"DuncanPenn"},{"id":"23395456","name":"Spencer Pratt","username":"spencerpratt"},{"id":"14541402","name":"Max Levchin","username":"mlevchin"},{"id":"293238354","name":"Bret Johnsen","username":"BretWJ"},{"id":"1899809291353169921","name":"Kilo","username":"kilocode"},{"id":"1300805399508066305","name":"Federico Cassano","username":"ellev3n11"},{"id":"35787166","name":"Nicki Minaj","username":"NICKIMINAJ"},{"id":"14224719","name":"UK Prime Minister","username":"10DowningStreet"},{"id":"10666172","name":"Sabine Hossenfelder","username":"skdh"},{"id":"2330593107","name":"Sualeh Asif","username":"sualehasif996"},{"id":"1870688634594312192","name":"Austin Justice","username":"AustinJustice"},{"id":"1874492187070615552","name":"Brivael Le Pogam","username":"brivael"},{"id":"13348","name":"Robert Scoble","username":"Scobleizer"},{"id":"32613163","name":"Brett Ratner","username":"BrettRatner"},{"id":"47195143","name":"Logan Graham","username":"logangraham"},{"id":"2024518793679294464","name":"ClaudeDevs","username":"ClaudeDevs"},{"id":"2051754537367588872","name":"White House Task Force to Eliminate Fraud","username":"WHFraudTF"},{"id":"1695890961094909952","name":"Cursor","username":"cursor_ai"},{"id":"463135269","name":"JRM","username":"StatlerLasVegas"},{"id":"1598444521918021632","name":"ARK Funds","username":"ARK_Funds"},{"id":"968053955845484545","name":"Sholto Douglas","username":"_sholtodouglas"},{"id":"27357824","name":"Chris Williamson","username":"ChrisWillx"},{"id":"10926202","name":"Adam Carolla","username":"adamcarolla"},{"id":"1535440467076186114","name":"HOUSE LOVERS","username":"hutdesigns"},{"id":"905399486","name":"James Bradbury","username":"jekbradbury"},{"id":"14914884","name":"crazybuster","username":"crazybuster"},{"id":"2041184913311797248","name":"Susie Wiles","username":"SusieWiles47"},{"id":"1087640384975577089","name":"NIK","username":"ns123abc"},{"id":"340613443","name":"Ronan Farrow","username":"RonanFarrow"},{"id":"816775","name":"Matt Garman","username":"mattsgarman"},{"id":"35199446","name":"Helen Andrews","username":"herandrews"},{"id":"1034256778114949120","name":"Yuri Milner","username":"yurimilner"},{"id":"2012653551407808512","name":"Mo","username":"atmoio"}],"meta":{"next_token":"TRUBIV5PR3CHIZZZ","result_count":50}}},"exampleRequest":{"max_results":50},"tags":["x402"],"displayCostAmount":"0.983","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.983/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.983","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.983","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5S1EMAV1vy2TMf34mkEkL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.983","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of accounts a given X/Twitter user is following, up to 100 results per call","exampleAgentPrompt":"Using Surplus Intelligence's X API proxy, fetch up to 100 accounts that Twitter user ID 44196397 is following.","exampleUseCases":null,"resultDescription":"A JSON response containing an array of user objects representing accounts the specified user follows, along with pagination metadata (next_token, result_count) and any errors. Each user object includes at minimum the account ID.","failureModes":["Invalid or non-numeric userId returns 400 or Twitter API error","User account suspended or not found returns 404","max_results out of range (must be 1-100) returns validation error","Insufficient USDC balance triggers x402 payment failure","Twitter API rate limit exceeded returns 429","Private/protected account following list returns authorization error"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve the following list of a Twitter/X user and want to pay per-call in USDC via x402 without managing Twitter API credentials. Prefer this over direct Twitter API access when operating in an agentic, crypto-native workflow that supports x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:43.854Z","isFirstParty":false}