# fetcher.sh Twitter Handle Lookup

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

Fetches public profile data for a Twitter/X user by their handle, paid per call in USDC via x402.

## Facts

- Endpoint: GET https://fetcher.sh/api/twitter/handle/%7Bhandle%7D
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetcher-sh-twitter-handle-lookup-02d0a3a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KKiiavuXAwHNYB23x_DzK

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-handle-lookup-02d0a3a6
```

Example prompt: Can you pull the public Twitter profile info for the handle @elonmusk — I want to see their bio, follower count, and tweet count?

## When to prefer this

Choose this endpoint when you need Twitter/X profile data without setting up Twitter Developer API credentials, OAuth flows, or subscriptions. Ideal for AI agents that need on-demand, pay-per-call social profile lookups without long-term commitment. Best for single-handle enrichment, lead research, or influencer vetting in automated pipelines where frictionless access matters more than bulk discounts.

## Known failure modes

- Handle does not exist — returns 404 or empty result
- Account is suspended or deactivated — endpoint may return error or empty profile
- Private/protected accounts — only public fields returned or access denied
- Rate limiting on the underlying scraping layer — may return 429 or timeout
- Invalid handle format — malformed path parameter may cause 400 error
- Payment failure via x402 — call not executed if USDC payment is rejected

## 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

Returns structured public profile data for the given Twitter/X handle, including fields such as display name, bio/description, follower count, following count, tweet count, account creation date, profile image URL, and verification status.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fetcher-sh-twitter-handle-lookup-02d0a3a6/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)