# fetcher.sh Twitter User Search

> fetcher.sh Twitter User Search is a paid API for AI agents from fetcher.sh, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Search Twitter/X for user accounts matching a query string, returning profile data for matching users

## Facts

- Endpoint: GET https://fetcher.sh/api/twitter/search/users
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetcher-sh-twitter-user-search-3a6c64fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L5OhrTsS_au5fuPF26zkR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fetcher-sh-twitter-user-search-3a6c64fc
```

Example prompt: Search Twitter for users related to 'AI safety research' and give me a list of matching accounts with their follower counts and bios.

## When to prefer this

Choose this endpoint when you need to discover or enumerate Twitter/X user accounts by keyword or name without setting up Twitter API credentials or OAuth. Ideal for AI agents that need to find influencers, researchers, brand accounts, or domain experts on Twitter programmatically, paying per call with USDC on Base rather than managing API subscriptions.

## Known failure modes

- Query returns no results if the search term is too niche or misspelled
- Rate limiting or blocking by Twitter may result in empty or partial results
- Payment failure (insufficient USDC balance) returns HTTP 402
- Ambiguous queries may return irrelevant user accounts
- Scraping disruptions during Twitter platform changes may cause temporary failures or incomplete data

## How this service works

fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.

## Output

A list of Twitter/X user profiles matching the search query, typically including username (handle), display name, bio/description, follower count, following count, verified status, and profile image URL for each matching account.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fetcher-sh-twitter-user-search-3a6c64fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fetcher.sh](https://www.zero.xyz/host/fetcher.sh/llms.txt)