# fetcher.sh Instagram User Stories API

> fetcher.sh Instagram User Stories API 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).

Fetches the current active stories for a given Instagram user by their user ID

## Facts

- Endpoint: GET https://fetcher.sh/api/instagram/user/%7Bid%7D/stories
- 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-stories-api-010e03f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OVKOdBtF6hn8TrdDKY9hv

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-stories-api-010e03f8
```

Example prompt: Can you grab the current active stories for Instagram user ID 12345678? I want to see what they've posted today.

## When to prefer this

Choose this endpoint when you need to programmatically access Instagram stories for a specific user without OAuth credentials, Instagram API access, or a developer account. It is ideal for AI agents doing social media monitoring, influencer tracking, or competitive analysis that need per-call pay-as-you-go access with no subscription overhead. It works best when you already have the numeric Instagram user ID.

## Known failure modes

- User ID not found or account does not exist — returns empty result or 404-style error
- User account is private — stories may not be accessible, returns access-restricted error
- User has no active stories — returns empty stories array
- Invalid user ID format — returns validation error
- Rate limiting or Instagram anti-scraping measures — returns 429 or service error
- Payment failure via x402 — returns 402 Payment Required if USDC balance is 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 a list of current active Instagram stories for the specified user, including story media (images/videos), timestamps, story type, expiry information, and associated metadata such as view counts or interactive elements where available.

## 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-stories-api-010e03f8/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)