{"uid":"cap_MjJ5XNsl7Dmr63S9a5-_x","slug":"x402-twit-sh-f3316bd2","name":"x402.twit.sh Bulk Twitter/X User Profile Lookup","description":"Bulk look up multiple Twitter/X user profiles by their numeric user IDs in a single request. Returns an array of full user profiles. Query param: ids (string, required) - comma-separated numeric Twitter user IDs, max 50, e.g. GET /users?ids=44196397,12,783214. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/users?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated numeric Twitter user IDs, max 50"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ids":"44196397,12,783214"}}},"response":{"data":[{"id":"44196397","name":"Elon Musk","entities":{"description":{"urls":[{"url":"https://t.co/dDtDyVssfm","indices":[0,23],"display_url":"Terafab.ai","expanded_url":"http://Terafab.ai"}]}},"location":"","username":"elonmusk","verified":true,"protected":false,"created_at":"2009-06-02T20:12:29.000Z","affiliation":{"url":"https://twitter.com/X","badge_url":"https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg","description":"X"},"description":"https://t.co/dDtDyVssfm","verified_type":"blue","public_metrics":{"like_count":233658,"media_count":4535,"tweet_count":104101,"listed_count":169534,"followers_count":240192484,"following_count":1353},"pinned_tweet_id":"2064187087184650253","profile_image_url":"https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg","profile_banner_url":"https://pbs.twimg.com/profile_banners/44196397/1774145451"},{"id":"12","name":"jack","entities":{"url":{"urls":[{"url":"https://t.co/ZEpOg6rn5L","indices":[0,23],"display_url":"primal.net/jack","expanded_url":"http://primal.net/jack"}]},"description":{}},"location":"","username":"jack","verified":true,"protected":false,"created_at":"2006-03-21T20:50:14.000Z","affiliation":{"url":"https://twitter.com/Square","badge_url":"https://pbs.twimg.com/profile_images/1285655593592791040/HtwPZgej_bigger.jpg","description":"Square"},"description":"no state is the best state","verified_type":"blue","public_metrics":{"like_count":39082,"media_count":2965,"tweet_count":30562,"listed_count":33129,"followers_count":8635223,"following_count":3},"pinned_tweet_id":"1833951636005552366","profile_image_url":"https://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_normal.jpg","profile_banner_url":"https://pbs.twimg.com/profile_banners/12/1742427520"},{"id":"783214","name":"X","entities":{"url":{"urls":[{"url":"https://t.co/Xp0xJlcROt","indices":[0,23],"display_url":"x.com","expanded_url":"https://x.com"}]},"description":{}},"location":"everywhere","username":"X","verified":true,"protected":false,"created_at":"2007-02-20T14:35:54.000Z","description":"what's happening?!","verified_type":"blue","public_metrics":{"like_count":5984,"media_count":2489,"tweet_count":15700,"listed_count":85272,"followers_count":60867687,"following_count":1},"profile_image_url":"https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_normal.jpg","profile_banner_url":"https://pbs.twimg.com/profile_banners/783214/1690175171"}]}},"exampleRequest":{"ids":"44196397,12,783214"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BVUbPwp6UogTo3rNnf6pJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Bulk look up multiple Twitter/X user profiles by their numeric user IDs in a single request, returning an array of full user profiles.","exampleAgentPrompt":"Can you pull up the full profiles for these Twitter user IDs: 44196397, 12, and 783214 — I need their usernames, follower counts, and bios.","exampleUseCases":null,"resultDescription":"Returns an array of full Twitter/X user profile objects in X v2 API-compatible JSON format, each including numeric ID, username, display name, bio/description, location, verified status, protected status, account creation date, profile image URL, profile banner URL, and public metrics (followers, following, tweets, likes, media, lists).","failureModes":["Missing or empty 'ids' query parameter returns an error","More than 50 IDs provided exceeds the batch limit","Non-numeric or malformed IDs result in errors or empty data for those entries","Deleted or suspended accounts may be omitted from results","Network or upstream Twitter API errors may return partial results or 5xx responses","Payment failure (402) if USDC payment is not properly attached"],"whenToPreferThis":"Use this endpoint when you have multiple known Twitter/X numeric user IDs and need to resolve them to full profiles in a single call (up to 50 at once). Prefer this over single-user lookup when batch efficiency matters. Use instead of search when you already know the exact numeric IDs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:44:42.746Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-f3316bd2"}