{"uid":"cap_Ud3feKrK9FOLphgOoRulo","slug":"twitter-surf-cascade-fyi-ead4278e","name":"Twitter Surf Batch User Fetch","description":"Pay-per-use Twitter/X data API with x402 micropayments.","url":"https://twitter.surf.cascade.fyi/users","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"data":[{"id":"44196397","name":"Elon Musk","username":"elonmusk"}],"meta":{"result_count":2,"has_next_page":false}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ids":"123456789,987654321,555666777"}}},"response":{"data":[{"id":"123456789","name":"Some Test User","username":"some_test_user","created_at":"2010-03-16T04:34:34.000Z","description":"Oops","public_metrics":{"like_count":2,"media_count":0,"tweet_count":4,"followers_count":112,"following_count":3},"cover_image_url":"","profile_image_url":"https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png"}],"meta":{"result_count":1,"has_next_page":false}}},"exampleRequest":{"ids":"123456789,987654321,555666777"},"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZmQziayaVqs_73dJ-wNGw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Batch fetch multiple Twitter/X user profiles by their user IDs in a single request","exampleAgentPrompt":"Can you look up the Twitter profiles for these user IDs all at once: 12345678, 87654321, and 11223344?","exampleUseCases":[{"title":"Analyze influencer network for campaign","prompt":"Pull the Twitter profiles for all these creator IDs at once so I can see their follower counts and bios: 98765432, 45678901, 23456789, and 56789012"},{"title":"Enrich customer list with social data","prompt":"Can you fetch the X profiles for this batch of user IDs and grab their display names and bios for our CRM: 11111111, 22222222, 33333333, 44444444, 55555555?"},{"title":"Monitor mentions from key accounts","prompt":"I collected these user IDs from our recent mentions—can you look up their full Twitter profiles all together to see who's been talking about us: 13579246, 24680135, 35791246?"}],"resultDescription":"Returns an array of Twitter/X user profile objects corresponding to the requested user IDs, including metadata such as display names, usernames, bios, follower counts, and other profile fields available via the Twitter Surf proxy.","failureModes":["Missing or empty 'ids' query parameter returns a validation error","Invalid or malformed user IDs may return partial results or errors for those IDs","Rate limiting or payment failure (x402) returns 402 Payment Required","Non-existent user IDs return empty or null entries for those IDs","Too many IDs in a single batch may exceed service limits"],"whenToPreferThis":"Use this endpoint when you need to resolve or enrich multiple Twitter/X user IDs into full profile data in a single call, avoiding the overhead of making one request per user. Ideal for pipelines that collect user IDs from follower lists, mention streams, or other sources and need to hydrate them into profile objects efficiently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:58:30.859Z","isFirstParty":false}