# API Direct – Instagram User Followers

> API Direct – Instagram User Followers is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Retrieve a paginated list of followers for an Instagram account by username or profile URL, with optional search filtering.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/instagram/user/followers?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-instagram-user-followers-486fa8c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AgEsI3wDKlm0quPy5cj5m

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 api-direct-instagram-user-followers-486fa8c1
```

Example prompt: Can you get me the first 3 pages of followers for the Instagram account @natgeo? I want to see who's following them.

## When to prefer this

Use this endpoint when you need to enumerate or search through the follower list of a specific Instagram account by username or URL. It is ideal for influencer research, audience analysis, and competitor monitoring on Instagram. Prefer this over generic scraping tools when you need structured, paginated follower data with optional name/username search filtering.

## Known failure modes

- Invalid or non-existent username returns an error or empty result
- Private Instagram accounts may block follower retrieval
- Verified (blue checkmark) accounts only return first page regardless of pages parameter
- Exceeding the pages maximum of 40 causes a validation error
- Rate limiting or payment failure returns a 402 or 429 response
- Malformed profile URL returns a parsing error

## How this service works

Get a user's followers by username or profile URL.

## Output

Returns paginated lists of Instagram follower accounts (up to 50 per page), including follower usernames and profile details. Up to 40 pages can be fetched per call (2,000 followers total). Verified accounts return only the first page. When a search query is provided, returns up to 50 matching followers in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "Instagram profile URL, e.g. https://instagram.com/natgeo (max 500 characters). Provide either username or url."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 40,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-40 (default: 1). Each page returns up to 50 accounts. Verified (blue checkmark) accounts return the first page only."
      },
      "query": {
       "type": "string",
       "maxLength": 100,
       "description": "Search the followers list by username or name (max 100 characters). Returns up to 50 matches in a single request; pages is ignored."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "Instagram username, with or without leading @ (max 100 characters). Provide either username or url."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-instagram-user-followers-486fa8c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)