{"uid":"cap_MNITkz-i2os191VKgAyuy","slug":"twit-sh-twitter-x-user-search-ef787698","name":"twit.sh Twitter/X User Search","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/search","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":["query"],"properties":{"query":{"type":"string","description":"Search keyword or phrase"},"next_token":{"type":"string","description":"Pagination cursor from previous response"}}}},"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}}],"meta":{"next_token":"abc123"}}},"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_st-hZ5_i_r6-PZ5I7OQZK","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":"Search Twitter/X users by keyword or phrase and return matching user profiles with public metrics","exampleAgentPrompt":"Search Twitter/X for users related to 'bitcoin' and give me their usernames, follower counts, and bios.","exampleUseCases":[{"title":"Influencer discovery for a campaign","prompt":"Find me Twitter users related to 'sustainable fashion' — I want their usernames, follower counts, and bio descriptions so I can shortlist influencers for a campaign."},{"title":"Competitor account research","prompt":"Search X for accounts mentioning 'open source LLM' in their profile and give me the top results with their follower counts and descriptions."},{"title":"Community mapping in a niche","prompt":"Look up Twitter users associated with 'DeFi' and list their usernames, follower counts, and bios — I want to map the major voices in that space."}],"resultDescription":"Returns a paginated list of Twitter/X user objects, each containing user ID, display name, username, verified status, bio/description, and public metrics (follower count, following count, tweet count, like count). Also includes a next_token for paginating through additional results.","failureModes":["No users found for the query — empty data array returned","Invalid or expired next_token — pagination fails","Query parameter missing — request rejected","Payment failure via x402 — request blocked","Twitter/X API rate limit reached upstream — temporary errors","Network timeout on real-time data fetch"],"whenToPreferThis":"Use this endpoint when you need to search and discover Twitter/X user accounts by keyword without setting up Twitter API credentials. Ideal for AI agents that need autonomous, pay-per-use access to user search on X without OAuth flows or API key management. Prefer this over direct Twitter API access when running headless or in environments where credential management is impractical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:48:03.224Z","isFirstParty":false}