# SocialFetch Instagram Reels Search

> SocialFetch Instagram Reels Search is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-15).

Search Instagram Reels by keyword with optional date range filtering and page-based pagination.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/instagram/search/reels
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-instagram-reels-search-dfeea3a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_STz72bIb_tPE3g8uF5dTA

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 socialfetch-instagram-reels-search-dfeea3a6
```

Example prompt: Search Instagram Reels for 'sustainable fashion' posted in the last week and show me the first page of results.

## When to prefer this

Use this endpoint when you need to search Instagram Reels by keyword topic, trend, brand, or hashtag concept — especially when date recency matters (e.g. last hour, last day, last week). Prefer this over profile-based Reels listing when you don't know the specific account and need broad discovery. Best for content research, trend monitoring, competitor analysis, or influencer discovery on Instagram.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Query exceeding 512 characters is rejected
- Invalid datePosted enum value returns a 400 error
- No results found for the query returns an empty result set
- Rate limiting or payment failure returns a 402 or 429 error
- Instagram service unavailability or blocking may result in empty or error response

## How this service works

Search Reels site-wide by keyword (not scoped to one profile — use instagram.profile.reels.list; not trending — use instagram.reels.trending.list; not audio-page — use instagram.audio.reels.list).

## Output

Returns a paginated list of Instagram Reels matching the search query, including reel metadata such as titles, descriptions, authors, URLs, engagement metrics, and post timestamps. Results are scoped to the requested page and optionally filtered by recency.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 1,
       "description": "1-based results page number. Omit to request the first page. Pagination is page-based."
      },
      "query": {
       "type": "string",
       "maxLength": 512,
       "minLength": 1,
       "description": "Search query text for Instagram Reels."
      },
      "datePosted": {
       "enum": [
        "last-hour",
        "last-day",
        "last-week",
        "last-month",
        "last-year"
       ],
       "type": "string",
       "description": "Optional filter for when matching reels were posted."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-instagram-reels-search-dfeea3a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)