{"uid":"cap_bKJyZulmQ7GOrc_d5OiMX","slug":"agentutility-x-users-lookup-66fda193","name":"AgentUtility X Users Lookup","description":"X users API / bulk Twitter profile lookup / public social profile lookup. Same read-only X API v2 backend as users. Accepts usernames or numeric user IDs and returns public profile and metric fields.","url":"https://x402.agentutility.ai/x-users","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: numeric X user IDs, used when usernames is omitted."},"mode":{"enum":["users"],"type":"string","description":"Optional. Operation mode; set to 'users' for bulk lookup. Accepts search, user, tweets, users, or user_tweets."},"user_ids":{"type":"array","items":{"type":"string"},"description":"Numeric X user IDs to look up. Up to 100. Used only when usernames is omitted."},"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."}}},"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"},"source":{"type":"string"},"requested":{"type":"integer"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"users","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_fM2mFw14ID0ADmLN9a91A","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":"Bulk lookup of public Twitter/X user profiles and metrics by username or numeric user ID via X API v2","exampleAgentPrompt":"Look up the public X profiles for the accounts @elonmusk, @sama, and @karpathy — I need their follower counts, bios, verified status, and tweet counts.","exampleUseCases":[{"title":"Influencer vetting for brand campaign","prompt":"Pull the public X profiles for these handles: @mrbeast, @mkbhd, and @marques — I want to see their follower counts, bio descriptions, and whether they're verified before we decide who to partner with."},{"title":"Resolve Twitter handles to user IDs","prompt":"I have a list of Twitter usernames — @naval, @paulg, @pmarca — can you fetch their numeric X user IDs along with their display names and account creation dates?"},{"title":"Monitor competitor social presence","prompt":"Grab the current public metrics for these X accounts: @openai, @anthropicai, and @mistralai — follower counts, tweet counts, and bios so I can compare their social footprint."}],"resultDescription":"Returns a structured array of public X/Twitter profile records for each requested username or user ID, including display name, bio, follower count, following count, tweet count, verified status, profile image URL, and account creation date as available from the X API v2 public fields.","failureModes":["Username or user ID not found — returns 404 or empty result for that entry","Rate limit or quota exceeded on the underlying X API v2","Invalid username format or malformed user ID — validation error","Account suspended or deactivated — no profile data returned","Payment failure via x402 protocol — request rejected before reaching X API","Partial results if some usernames in a bulk request are invalid while others succeed"],"whenToPreferThis":"Choose this endpoint when you need public X/Twitter profile data — follower counts, bios, verification status, or account metrics — for one or more accounts in a single call. It is the right choice for bulk resolution of usernames to profile metadata, influencer vetting, social graph enrichment, or any workflow where you need read-only X profile fields without building your own X API integration. It accepts both @usernames and numeric user IDs, making it useful for ID-to-profile resolution as well.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:22.563Z","isFirstParty":false}