{"uid":"cap_8wxo_9WlgC4iLlrbl49tc","slug":"x402-twit-sh-571a421b","name":"x402.twit.sh Twitter/X User Search","description":"Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/users/search?utm_source=zero.xyz","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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"query":"artificial intelligence"}}},"response":{"_truncated":true,"_originalSize":13771}},"exampleRequest":{"query":"artificial intelligence"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.93","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","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_xWOYvA4pJ5uJybpVuXCwq","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 for user accounts matching a keyword or phrase, returning paginated user profiles","exampleAgentPrompt":"Can you find me Twitter/X user accounts related to 'renewable energy' — I want to discover people or organizations posting about that topic?","exampleUseCases":null,"resultDescription":"Returns up to 20 Twitter/X user profiles per page in X v2 API-compatible JSON, including handles, display names, bios, and follower counts, plus a next_token cursor for paginating through additional results.","failureModes":["Missing required 'query' parameter returns a 400 error","Invalid or expired next_token returns a pagination error","Empty result set when no users match the query","Rate limiting or payment failure (402) if USDC payment not provided","Query too long or containing unsupported characters may return an error"],"whenToPreferThis":"Use this endpoint when you need to discover Twitter/X user accounts by topic, name, or keyword — especially for influencer research, community mapping, or finding experts in a subject area. Prefer this over follower/following endpoints when you don't have a specific user ID and need to explore accounts by interest or identity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":17,"lastUsedAt":"2026-09-30T07:33:29.879Z","lastSuccessfullyRanAt":"2026-09-30T07:33:29.879Z","lastHealthCheckAt":"2026-10-29T13:10:12.894Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-571a421b"}