# StableSocial Instagram Followers

> StableSocial Instagram Followers is a paid API for AI agents from StableSocial at stablesocial.dev, paid per call via MPP or x402, $0.06/call, status unknown (last checked 2026-10-10).

Retrieves a paginated list of followers for a given Instagram username

## Facts

- Endpoint: POST https://stablesocial.dev/api/instagram/followers?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: StableSocial
- Docs: https://stablesocial.dev
- Website: https://stablesocial.dev
- Tags: tiktok, instagram, facebook, reddit, scraping, social, data, x402
- Canonical page: https://www.zero.xyz/c/stablesocial-followers-dc64a62e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wPWamEX-mJSj0iOwaP8DN

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 stablesocial-followers-dc64a62e -d '<json body>'
```

Example prompt: Can you pull up to 500 followers for the Instagram account @natgeo and give me the full list?

## When to prefer this

Use this endpoint when you need to programmatically retrieve the follower list of an Instagram account, especially for audience analysis, influencer research, or social graph mapping. Prefer this over manual browsing when you need structured, paginated follower data at scale via a pay-per-request model.

## Known failure modes

- Invalid or non-existent Instagram handle returns an error
- Private account may return empty or restricted follower list
- Exceeding rate limits may result in partial results or errors
- Missing required 'handle' field returns a validation error
- Invalid cursor returns a pagination error

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

Returns a list of follower profiles for the specified Instagram account, including user metadata, up to the requested max_followers count, along with a pagination cursor for fetching additional results.

## Example request

```json
{
 "handle": "natgeo",
 "max_followers": 100,
 "max_page_size": 50
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "handle": {
   "type": "string",
   "minLength": 1,
   "description": "Instagram username"
  },
  "max_followers": {
   "type": "integer",
   "default": 500,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Maximum number of followers to collect"
  },
  "max_page_size": {
   "type": "integer",
   "default": 100,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Results per page"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "clx0000000000000000000000",
  "token": "eyJ...",
  "status": "pending",
  "pollUrl": "https://stablesocial.dev/api/jobs/clx0000000000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-followers-dc64a62e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)
