# SocialFetch Instagram Hashtag Search

> SocialFetch Instagram Hashtag 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 public Instagram posts and Reels by hashtag with optional filters for media type and recency.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/instagram/search/hashtags
- 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-hashtag-search-f052ef9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C2OoY7fDSkVijM9T53Q0y

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-hashtag-search-f052ef9e
```

Example prompt: Search Instagram for public posts and Reels tagged #sustainablefashion posted in the last week — show me both regular posts and Reels.

## When to prefer this

Use this endpoint when you need to discover or monitor public Instagram content associated with a specific hashtag, especially when filtering by content type (posts vs Reels only) or recency (last hour to last year). Prefer this over general web search when you need structured Instagram post data rather than HTML pages.

## Known failure modes

- Invalid or empty hashtag returns a 400 error
- Hashtag not found or no matching posts returns an empty results list
- Invalid cursor causes a pagination error
- Invalid mediaType or datePosted enum value returns a 400 validation error
- Rate limit exceeded returns a 429 error
- Payment failure returns a 402 error

## How this service works

Search public Instagram posts and Reels by hashtag.

## Output

A list of public Instagram posts and/or Reels matching the given hashtag, including post metadata such as captions, media URLs, engagement signals, timestamps, and a pagination cursor for fetching additional results.

## 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": [
      "hashtag"
     ],
     "properties": {
      "cursor": {
       "type": "string",
       "minLength": 1,
       "description": "Pagination cursor returned by a previous response."
      },
      "hashtag": {
       "type": "string",
       "maxLength": 256,
       "minLength": 1,
       "description": "Hashtag to search for. A leading # is optional."
      },
      "mediaType": {
       "enum": [
        "all",
        "reels"
       ],
       "type": "string",
       "description": "Content filter. Use `all` for posts and Reels, or `reels` for Reels only. Default: `all`."
      },
      "datePosted": {
       "enum": [
        "last-hour",
        "last-day",
        "last-week",
        "last-month",
        "last-year"
       ],
       "type": "string",
       "description": "Optional filter for when matching posts 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-hashtag-search-f052ef9e/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)