{"uid":"cap_aH3UcshPvDU-AnLCeslQS","slug":"www-surplusintelligence-ai-b0242243","name":"Surplus Intelligence X/Twitter Single User Lookup by ID","description":"X/Twitter API v2 via Surplus Intelligence: Single user lookup (1 unit)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/users/:userId","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["userId"],"properties":{"userId":{"type":"string","description":"Numeric X/Twitter user ID."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{},"meta":{"type":"object"},"errors":{"type":"array"}},"additionalProperties":true}}}}},"responseSchema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","name","username"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"}}}}},"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"userId":"44196397"},"queryParams":{}}},"response":{"data":{"id":"44196397","name":"Elon Musk","username":"elonmusk"}}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0128","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.0128/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0128","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0128","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wQioaK1Gabu-a79Uip-tS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0128","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches profile data for a single X/Twitter user by their numeric user ID via the Twitter API v2","exampleAgentPrompt":"Look up the Twitter/X profile for user ID 44196397 and tell me their display name, username, and account details.","exampleUseCases":[{"title":"Verify influencer identity before partnership","prompt":"I'm considering a collaboration with someone who claims to be a major tech influencer. Can you look up their Twitter profile using their user ID 1445764532 and tell me if they actually have a large following and what their bio says?"},{"title":"Track down contact info from numeric ID","prompt":"I have a list of Twitter user IDs from our customer database and need to find out the current usernames and display names for each one. Can you start by looking up user ID 123456789 and getting me their profile details?"},{"title":"Investigate account authenticity quickly","prompt":"Someone just mentioned a Twitter account in a conversation, and I want to make sure it's legitimate. Look up user ID 987654321 for me and tell me what their account description says and how many followers they have."}],"resultDescription":"Returns a Twitter API v2 user object containing profile data such as name, username, description, follower counts, and other account metadata for the specified user ID.","failureModes":["Invalid or non-numeric userId returns an error","User ID does not exist on X/Twitter returns a not-found error","Payment failure or insufficient USDC balance blocks the request","Rate limiting from the underlying Twitter API v2","Suspended or deactivated account may return limited data"],"whenToPreferThis":"Use this endpoint when you have a known numeric Twitter/X user ID and need to retrieve that user's profile information in a single API call. Prefer this over username-based lookup when you already have the numeric ID. Cost-effective at 1 unit ($0.0128 USDC) for individual user lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:42.246Z","isFirstParty":false}