# fetcher.sh Instagram User ID Lookup

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

Resolves an Instagram username (handle) to its numeric user ID

## Facts

- Endpoint: GET https://fetcher.sh/api/instagram/userid/%7Bhandle%7D
- Price: $0.004/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-instagram-user-id-lookup-591a5595
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BmltWd4l1SmcLMyqOmGMS

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-instagram-user-id-lookup-591a5595
```

Example prompt: What is the numeric Instagram user ID for the handle 'natgeo'?

## When to prefer this

Choose this endpoint when you need to programmatically resolve an Instagram username to its numeric user ID without setting up OAuth or an Instagram developer account. Ideal for AI agents that need to enrich datasets, bootstrap monitoring pipelines, or feed downstream Instagram data endpoints — all paid per-call in USDC with no subscription required.

## Known failure modes

- Handle does not exist — returns 404 or empty result
- Instagram rate limiting or blocking causes data unavailability
- Handle recently changed or deactivated — stale or missing result
- Malformed handle input — returns error or no match
- Payment failure via x402 — 402 response if USDC payment is rejected or insufficient

## 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 the numeric Instagram user ID corresponding to the provided handle, enabling downstream API calls or data pipelines that require a user ID rather than a username.

## 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-instagram-user-id-lookup-591a5595/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)