{"uid":"cap_Mz_IwrEc30PiX1dUQSW_3","slug":"twit-sh-twitter-x-user-lookup-by-id-edf603f1","name":"twit.sh Twitter/X User Lookup by ID","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/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"],"type":"string"},"queryParams":{"type":"object","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated numeric Twitter user IDs, max 50"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_2jARBvnRMg4Z8PWiaqUek","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches public profile data for up to 50 Twitter/X users by their numeric user IDs, returning name, username, bio, and public engagement metrics.","exampleAgentPrompt":"Can you pull up the Twitter profile info and follower counts for these user IDs: 9253672, 44196397, and 783214 — I want their display names, usernames, bios, and public metrics.","exampleUseCases":[{"title":"Influencer vetting for brand campaign","prompt":"I have a list of Twitter user IDs for potential influencers — 783214, 44196397, and 17919972 — can you fetch their follower counts, tweet counts, and bios so I can decide who to reach out to?"},{"title":"Resolve user IDs to profile details","prompt":"I have a bunch of numeric Twitter user IDs from our analytics export and I need to know who they actually are — can you look up the usernames, display names, and descriptions for IDs 9253672, 6253282, and 2244994945?"},{"title":"Monitor public metrics for known accounts","prompt":"Check the current follower counts and tweet counts for these X accounts by their IDs: 1234567, 7654321, and 9876543 — I want to track how their numbers are changing over time."}],"resultDescription":"Returns an array of user objects, each containing numeric ID, display name, username handle, verified status, bio description, and public_metrics with follower count, following count, tweet count, and like count. Up to 50 users per request.","failureModes":["Invalid or non-existent user IDs return no matching entry in the data array","Exceeding 50 IDs per request may result in an error or truncation","Payment failure via x402/USDC results in a 402 response and no data","Malformed comma-separated ID string returns a 400 or empty response","Suspended or deactivated accounts may be omitted from results"],"whenToPreferThis":"Use this endpoint when you have numeric Twitter/X user IDs and need to resolve them to profile details or public metrics without managing API keys or OAuth. It is ideal for AI agents operating autonomously that need social profile enrichment or influencer stats on-demand, paying per request in USDC. Prefer this over the official Twitter API when you want zero-setup access with micropayment billing rather than a developer account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:52.996Z","isFirstParty":false}