# agdata Instagram Data API

> agdata Instagram Data API is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.0255/call, status unknown (last checked 2026-10-14).

Fetches public Instagram data — profiles, hashtag posts, searches, or user posts — as structured JSON, paid per call in stablecoins with no account required.

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/mpp/instagram?utm_source=zero.xyz
- Price: $0.0255/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-instagram-data-api-3101b78f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dlVm7SGa9VVprJTbt_1gK

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 agdata-instagram-data-api-3101b78f -d '<json body>'
```

Example prompt: Pull the last 10 posts from the Instagram profile 'natgeo' and give me each post's caption, likes, views, and media URL.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Instagram data — posts, profiles, hashtags, or search results — without managing Instagram API credentials or OAuth. It is ideal for agents that need fresh social data on demand, paid per call in USDC with no account setup, particularly for influencer research, social listening, or content analytics pipelines.

## Known failure modes

- Private or restricted account returns empty results or an error
- Invalid mode enum value causes a 400 validation error
- Query string exceeding 500 characters is rejected
- Limit outside 1–20 range causes a validation error
- Rate limiting or Instagram anti-scraping blocks may cause intermittent failures
- Payment in insufficient amount or unsupported stablecoin causes a 402 error
- Non-existent username or hashtag returns empty results array

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

A JSON object (or array) containing per-post fields: post ID, shortcode, URL, media URL, media type, author username and display name, caption text, hashtags, likes count, views count, comments count, and posted_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "hashtag",
    "search",
    "user"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "39831183…",
  "url": "https://…",
  "likes": 77530,
  "views": 3274931,
  "author": "natgeo",
  "caption": "Presente…",
  "hashtags": [],
  "media_url": "https://…",
  "posted_at": "2026-09-…",
  "shortcode": "DdG4RIxI…",
  "media_type": "video",
  "author_name": "National…",
  "comments_count": 496
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-instagram-data-api-3101b78f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)