{"uid":"cap_5T8bGwyO_tYxZLyq-hl0F","slug":"botsmith-x-user-search-893a88e0","name":"botsmith X User Search","description":"X User Search ($0.01/call): Find X (Twitter) accounts by keyword: up to 20 matching accounts per call with full profiles (bio, follower counts, account age, verification) as clean JSON, plus a cursor for more. No X account or API key needed.","url":"https://x402.botsmith.dev/x/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","maxLength":100,"minLength":1,"description":"Keyword to match against names, handles and bios, e.g. \"x402\""},"cursor":{"type":"string","pattern":"^[A-Za-z0-9+/=_|-]{1,1000}$","description":"Pagination cursor from a previous call"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["users","hasNextPage","nextCursor"],"properties":{"users":{"type":"array","items":{"type":"object","required":["handle","id","name","bio","url","location","profileImage","verified","followers","following","tweetCount","createdAt","accountAgeDays"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"object","required":["blue","type"],"properties":{"blue":{"type":"boolean"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 account creation time"},"followers":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"following":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"tweetCount":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"profileImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountAgeDays":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"description":"Up to 20 matching accounts"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasNextPage":{"type":"boolean"}},"additionalProperties":false}}}}},"responseSchema":null,"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_97-JpBLfPgGJwtUO0Zu68","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 X (Twitter) accounts by keyword, returning up to 20 full profiles per call with bio, follower counts, account age, and verification status as clean JSON.","exampleAgentPrompt":"Search X for accounts related to 'x402' and show me their handles, follower counts, bios, and whether they're verified.","exampleUseCases":[{"title":"Influencer discovery for a niche","prompt":"Find me X accounts related to 'decentralized finance' — I want to see their follower counts, bios, and verification status so I can identify potential influencers to reach out to."},{"title":"Competitor brand monitoring","prompt":"Search X for accounts that mention 'botsmith' in their name or bio and give me their handles, follower counts, and account ages."},{"title":"Community prospecting for outreach","prompt":"Find Twitter accounts associated with the keyword 'x402' — show me up to 20 results with full profiles including bios, followers, and whether they have blue verification."}],"resultDescription":"Returns a JSON object containing an array of up to 20 user profiles (each with handle, id, name, bio, URL, location, profile image, verification object with blue status and type, follower count, following count, tweet count, account creation timestamp, and account age in days), a hasNextPage boolean, and a nextCursor string for paginating additional results.","failureModes":["Empty results if the keyword matches no X accounts","Invalid or expired cursor returns an error or restarts pagination","Query string too long (>100 chars) is rejected by schema validation","Rate limits or X platform downtime may cause failures","Payment not completed results in 402 response with no data"],"whenToPreferThis":"Use this endpoint when you need to discover X (Twitter) accounts by keyword without having your own X API credentials. It is ideal for agent workflows that require finding users, influencers, or communities around a topic, since it returns rich profiles including follower counts, account age, and verification status. Prefer it over X's native API when you want a pay-per-call model with no OAuth setup or X developer account required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:37:06.314Z","isFirstParty":false,"canonicalSlug":"botsmith-x-user-search-893a88e0"}