# API Direct – Instagram Post Search

> API Direct – Instagram Post Search 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).

Search for Instagram posts by keyword, optionally including AI-powered sentiment and emotion analysis per post.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/instagram/posts?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-post-search-a683b7d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lXt1y1agKQnbg1p8xB9Fe

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-post-search-a683b7d1
```

Example prompt: Search Instagram for posts about 'sustainable fashion' — grab the first 3 pages of results and include sentiment analysis for each post so I can see the emotional tone.

## When to prefer this

Choose this endpoint when you need to discover public Instagram posts around a specific keyword or topic — especially useful for social listening, brand monitoring, competitive research, or trend analysis. If you also need emotional tone data per post, enable the sentiment flag to get structured emotion scores without a separate enrichment step. Prefer this over user-profile endpoints when you want broad topic coverage rather than a specific account's feed.

## Known failure modes

- Query starting with @ or # returns an error — keyword must not begin with those characters
- Empty result set if the keyword has no matching public Instagram posts
- Pagination limit exceeded if pages parameter is set above 20
- Rate limiting or payment failure if USDC balance is insufficient (billed per page fetched)
- Truncated results if query exceeds 500 characters

## How this service works

Search for Instagram posts by keyword.

## Output

A merged list of public Instagram posts matching the keyword, across up to 20 pages. Each post includes typical post metadata (content, author, engagement, etc.). When sentiment analysis is enabled, each post also includes an emotions breakdown (joy, trust, fear, surprise, sadness, disgust, anger, anticipation — each scored 0-100), a dominant_emotion field, an emotional_intensity score (0-10), and a polarity label (positive, negative, or neutral).

## 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": [
      "query"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 20,
       "minimum": 1,
       "description": "Number of pages to fetch and merge into one response (1-20, billed per page)"
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "description": "Search keyword (max 500 characters). Cannot start with @ or #, though either character may appear elsewhere in the query."
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any post t"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-instagram-post-search-a683b7d1/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)