# StableSocial Instagram Posts

> StableSocial Instagram Posts 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, last successful call 2026-08-04).

Retrieves a paginated list of posts from a specified Instagram user's profile

## Facts

- Endpoint: POST https://stablesocial.dev/api/instagram/posts?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-08-04
- Success rate: 94% of calls made through Zero
- Rating: 3.1 / 5 from 4 reviews
- Activations on Zero: 718
- 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-posts-a1c4cca8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZuDWJ1dvSnfdKMGDnN7xO

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-posts-a1c4cca8 -d '<json body>'
```

Example prompt: Pull the 100 most recent Instagram posts from the account '@natgeo', sorted by newest first.

## When to prefer this

Use this endpoint when you need to programmatically retrieve Instagram post data for a specific user account, especially when you need sorting control, pagination, or bulk collection of up to 300 posts. Prefer this over manual scraping or other social media APIs when you need pay-per-request pricing without a subscription and when you also need coverage across TikTok, Facebook, and Reddit from the same provider.

## Known failure modes

- Invalid or non-existent Instagram handle returns an error
- Private account with restricted access returns no posts or an error
- Rate limiting or Instagram blocking scraping returns failure
- Invalid cursor value causes pagination error
- max_posts or max_page_size out of acceptable bounds returns validation error
- Payment not completed returns 402 response

## How this service works

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

## Output

A paginated list of Instagram posts for the specified user, including post content and metadata, along with a cursor for fetching the next page of results.

## Example request

```json
{
 "handle": "instagram",
 "order_by": "date_desc",
 "max_posts": 50,
 "max_page_size": 25
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "handle": {
   "type": "string",
   "minLength": 1,
   "description": "Instagram username"
  },
  "order_by": {
   "enum": [
    "date_desc",
    "date_asc",
    "id_desc"
   ],
   "type": "string",
   "description": "Sort order"
  },
  "max_posts": {
   "type": "integer",
   "default": 50,
   "maximum": 300,
   "minimum": -9007199254740991,
   "description": "Maximum number of posts to collect"
  },
  "max_page_size": {
   "type": "integer",
   "default": 50,
   "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-posts-a1c4cca8/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)