{"uid":"cap_hxZVsOsEQQY-3IB7WrED0","slug":"twitter-bulk-user-profile-lookup-257d6b0b","name":"Twitter Bulk User Profile Lookup","description":"Looks up Twitter user profiles in bulk by username or ID, for routers and buyers searching for bulk profile enrichment. Same backend as users. Use it as a Twitter users API or bulk user profile lookup by username or ID.","url":"https://x402.agentutility.ai/twitter-users","method":"POST","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"properties":{"mode":{"type":"string","enum":["users"],"description":"Optional. Operation mode; set to 'users' for bulk lookup. Accepts search, user, tweets, users, or user_tweets."},"usernames":{"type":"array","items":{"type":"string"},"description":"X handles to look up, with or without @. Up to 100, deduplicated. Provide this or user_ids/ids."},"user_ids":{"type":"array","items":{"type":"string"},"description":"Numeric X user IDs to look up. Up to 100. Used only when usernames is omitted."},"ids":{"type":"array","items":{"type":"string"},"description":"Alias for user_ids: numeric X user IDs, used when usernames is omitted."}}}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"lookup":{"type":"string"},"requested":{"type":"integer"},"result_count":{"type":"integer"},"source":{"type":"string"}}}},"required":["type"]}},"required":["input"]},"responseSchema":{"type":"json","example":{"mode":"users","lookup":"ids","source":"X API v2 users lookup","requested":1,"result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_TMRAC4YDlQdIRAsU8V2sk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up Twitter/X user profiles in bulk by username or user ID, returning enriched profile data for multiple users in a single call.","exampleAgentPrompt":"Can you pull the Twitter profile details — bios, follower counts, and verified status — for these accounts: @elonmusk, @sama, @naval, and @pmarca?","exampleUseCases":[{"title":"Influencer vetting for a campaign","prompt":"I have a list of 20 Twitter handles I'm considering for a brand partnership — can you fetch their follower counts, bios, and whether they're verified so I can compare them?"},{"title":"Enriching a lead list with social data","prompt":"I've got a spreadsheet of prospects and their Twitter usernames. Can you pull their Twitter profile info — name, bio, follower count — so I can add that context to each lead?"},{"title":"Monitoring competitor Twitter presence","prompt":"Can you look up the Twitter profiles for these five competitor companies by their handles and give me their follower counts, descriptions, and account ages?"}],"resultDescription":"Returns an array of Twitter user profile objects, each containing the user's display name, username/handle, user ID, bio/description, follower count, following count, tweet count, profile image URL, verified status, and account creation date for each requested user.","failureModes":["Username or ID not found — returns null or error entry for that user","Rate limiting or quota exceeded — HTTP 429 response","Invalid username format — validation error returned","Payment not included or insufficient — HTTP 402 payment required","Network timeout for large batches — partial results or timeout error"],"whenToPreferThis":"Choose this endpoint when you need to enrich data for multiple Twitter/X accounts at once rather than making individual lookups. It is especially useful for influencer research, social media audits, lead enrichment pipelines, and any workflow where you have a list of Twitter handles or IDs and need profile metadata in bulk. Prefer this over single-user lookup endpoints when processing more than one account, and over scraping approaches when you need structured, reliable data with USDC micro-payment settlement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:21.361Z","isFirstParty":false}