{"uid":"cap_iwbKU-htYj8DHIDGTEaLY","slug":"www-surplusintelligence-ai-b3150c2e","name":"Surplus Intelligence X/Twitter User Lookup","description":"X/Twitter API v2 via Surplus Intelligence: User lookup (1 unit)","url":"https://www.surplusintelligence.ai/x402/api/twitter/v2/users","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"},"queryParams":{"type":"object","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated X/Twitter user IDs."}},"additionalProperties":true}},"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","errors"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","name","username"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"}}}},"errors":{"type":"array","items":{"type":"object","required":["type","title","value","detail","parameter","resource_id","resource_type"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"detail":{"type":"string"},"parameter":{"type":"string"},"resource_id":{"type":"string"},"resource_type":{"type":"string"}}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ids":"123456789,987654321,111222333"}}},"response":{"data":[{"id":"123456789","name":"Some Test User","username":"some_test_user"},{"id":"111222333","name":"Martin Marks","username":"marks_harrison"}],"errors":[{"type":"https://api.twitter.com/2/problems/resource-not-found","title":"Not Found Error","value":"987654321","detail":"Could not find user with ids: [987654321].","parameter":"ids","resource_id":"987654321","resource_type":"user"}]}},"exampleRequest":{"ids":"123456789,987654321,111222333"},"tags":["x402"],"displayCostAmount":"0.032400","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.032400/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_bwwpjkN9vOqc5AtfStaOC","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":"Looks up Twitter/X user profile data by numeric user ID(s) via the X/Twitter API v2, proxied through Surplus Intelligence with x402 micropayment.","exampleAgentPrompt":"Look up the Twitter/X user profiles for these user IDs: 12345678, 87654321, 11223344 — I need their profile data from the X API v2.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 'data' array containing profile information for the requested user IDs, plus optional 'meta' and 'errors' fields following the X/Twitter API v2 response format.","failureModes":["Invalid or malformed user IDs return error objects in the errors array","Non-existent user IDs return no data entry for that ID","Missing 'ids' query parameter causes request failure","Rate limits or upstream X API errors propagate as HTTP error responses","Payment failure (x402) prevents request from completing"],"whenToPreferThis":"Use this endpoint when you have one or more numeric X/Twitter user IDs and need to resolve them to profile data, especially in agentic workflows requiring micropayment-based API access without managing Twitter API credentials directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:39.555Z","isFirstParty":false}