Search Twitter/X users by keyword, pay-per-request in USDC on Base via x402.
What it does
The `/users/search` endpoint on twit.sh lets you search Twitter/X for user accounts matching a keyword or phrase. It returns up to 20 user profiles per page with cursor-based pagination support. Each request costs $0.01 USDC, settled on Base mainnet via the x402 payment protocol — no API keys, no OAuth, no account creation required.
twit.sh is a payment-gated Twitter/X data API that returns X v2 API-compatible JSON. The broader API surface includes user lookup (by username, ID, or bulk), follower/following lists, tweet search with advanced filters, tweet timelines, quote tweets, replies, retweet lists, community and list data, X Articles in markdown, and authenticated write actions (post, like, retweet, bookmark, follow/unfollow). All endpoints follow the same x402 flow: the server responds with 402 Payment Required and a machine-readable payment challenge, the caller settles in USDC on Base, then retries with a payment proof header to receive data.
The data is described as sourced from the open web — publicly available profile and post information. Pricing across the API ranges from $0.0025 to $0.01 USDC per call depending on the endpoint. An npm CLI skill (`npx twitsh`) is available for integration with AI agents such as Claude Code, Cursor, OpenClaw, and others.
Capabilities
Use cases
- —Finding Twitter/X user accounts matching a keyword for lead generation or research
- —Building agent workflows that discover and monitor relevant Twitter accounts autonomously
- —Enriching CRM or analytics pipelines with Twitter user profile data
- —Searching for influencers or experts in a specific topic area
- —Programmatic social listening across user profiles
Fit
Best for
- —AI agents that need autonomous, keyless access to Twitter/X user data
- —Developers who want pay-per-request pricing without X API subscription tiers
- —Workflows requiring X v2-compatible JSON without managing OAuth credentials
Not for
- —High-volume bulk scraping (pay-per-request cost adds up at scale)
- —Applications requiring Twitter streaming or real-time push notifications
- —Users who need authenticated write actions without Twitter session cookies
Quick start
# Search for Twitter/X users matching a keyword
curl -X GET "https://x402.twit.sh/users/search?query=bitcoin"
# Returns 402 with payment challenge; settle in USDC on Base,
# then retry with X-PAYMENT header to get results.Example
Request
{
"url": "https://x402.twit.sh/users/search?query=bitcoin",
"method": "GET",
"headers": {
"X-PAYMENT": "<x402 payment proof>"
}
}Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing for all endpoints. The endpoint is live (402 challenge captured). However, response schemas for this specific endpoint are not documented (only 200 "Success" with no body schema), and no example response JSON is available. The landing page provides good context but detailed docs pages return 404.
Warnings
- —Response schema for /users/search is not documented — the 200 response only says 'Success' with no body definition.
- —Write actions (like, follow, retweet, tweet) require raw Twitter session cookies (auth_token, ct0) passed as query parameters, which raises security concerns.
- —No rate limit information is documented.
- —Docs, pricing, and API sub-pages on x402.twit.sh return 404 — documentation is limited to the landing page and OpenAPI spec.
Citations
- —The /users/search endpoint searches Twitter/X for user accounts matching a keyword, returns up to 20 users per page with pagination, and costs $0.01 USDC per request.https://x402.twit.sh
- —twit.sh uses the x402 payment protocol — agents pay per request in USDC on Base mainnet with no account required.https://x402.twit.sh
- —Data is sourced from the open web — publicly available profile and post information, shaped into X v2-compatible JSON.https://x402.twit.sh
- —An npm CLI skill (npx twitsh) is available for integration with AI agents.https://x402.twit.sh
- —Pricing ranges from $0.0025 to $0.01 USDC per call across endpoints.https://x402.twit.sh