{"uid":"cap_K0A6SZAbNMOJwVf2J_YJo","slug":"x-twitter-bulk-user-profile-lookup-c926ae34","name":"X (Twitter) Bulk User Profile Lookup","description":"Users API / bulk X user lookup / Twitter users lookup by usernames or IDs. Read-only X API v2 users lookup route matching market demand for bulk public profiles. Pass usernames or user_ids/ids and receive id, username, display name, bio, verification fields, created_at, followers, following, tweet count, and listed count. Requires X_BEARER_TOKEN; no posting, following, DM access, or account mutation.","url":"https://x402.agentutility.ai/users?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{"ids":{"type":"array","items":{"type":"string"},"description":"Alias for user_ids."},"mode":{"enum":["users"],"type":"string","description":"Use 'users' for bulk public profile lookup."},"user_ids":{"type":"array","items":{"type":"string"},"description":"Numeric X user IDs. Up to 100."},"usernames":{"type":"array","items":{"type":"string"},"description":"X/Twitter handles, with or without @. Up to 100."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"public_metrics":{"type":"object","properties":{"followers_count":{"type":"integer"}}}}}},"lookup":{"type":"string"},"source":{"type":"string"},"requested":{"type":"integer"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"users","users":[{"id":"99","username":"bankrbot","public_metrics":{"followers_count":1234}}],"lookup":"usernames","source":"X API v2 users lookup","requested":2,"result_count":2}},"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_ms7j5D-mrLaQlV4n-_ppx","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 one or more X (Twitter) user profiles by username or user ID, returning public account metadata including bio, follower counts, and verification status.","exampleAgentPrompt":"Can you look up the public profiles for these Twitter accounts — @elonmusk, @OpenAI, and @sama — and give me their follower counts, bios, and whether they're verified?","exampleUseCases":[{"title":"Influencer vetting for brand campaign","prompt":"I'm evaluating these 10 X accounts for a sponsorship deal — can you pull their follower counts, following counts, tweet counts, and bios so I can compare them side by side?"},{"title":"Resolve usernames to user IDs for data pipeline","prompt":"I have a list of Twitter handles I need to convert to numeric user IDs for a dataset I'm building — can you look them all up at once and give me their IDs along with their display names?"},{"title":"Check account age and credibility signals","prompt":"Can you look up these X accounts and tell me when each was created, how many followers they have, and if any of them are verified? I want to know if they're established accounts or newly created ones."}],"resultDescription":"Returns an array of user objects, each containing: user ID, username, display name, bio/description, verification fields, account creation date, follower count, following count, tweet count, and listed count. Read-only; no posting or account mutation.","failureModes":["Invalid or non-existent username/user ID returns an error or empty result for that entry","Missing or invalid X_BEARER_TOKEN causes authentication failure","Rate limits from the underlying X API v2 may throttle bulk requests","Suspended or deactivated accounts may return partial or no data","Exceeding batch size limits may cause request rejection"],"whenToPreferThis":"Choose this endpoint when you need to bulk-fetch public profile metadata (follower counts, bios, verification, account age) for one or more X/Twitter accounts by username or ID in a single call. It is ideal for influencer research, social graph enrichment, username-to-ID resolution, and any read-only social analytics workflow. Prefer it over scraping or direct X API integration when you need a simple, USDC-settled, agent-callable interface without managing OAuth or X developer credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:39:46.414Z","isFirstParty":false,"canonicalSlug":"x-twitter-bulk-user-profile-lookup-c926ae34"}