# GEDX402 Social – Instagram Hashtag Search (SociaVault)

> GEDX402 Social – Instagram Hashtag Search (SociaVault) is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.014/call, status unknown (last checked 2026-10-31).

Search Instagram posts by hashtag, with optional filters for media type, date posted, and pagination cursor, via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/instagram/search/hashtag?utm_source=zero.xyz
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-instagram-hashtag-search-sociavault-c6e8e5c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dh5HfOR_ruj1OCo0pYsxp

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 gedx402-social-instagram-hashtag-search-sociavault-c6e8e5c8
```

Example prompt: Can you pull the latest Instagram posts tagged with #sustainablefashion, filtered to images only and posted recently?

## When to prefer this

Choose this endpoint when you need to programmatically search and retrieve Instagram posts by hashtag with optional filtering by media type and date, and you are comfortable with per-call x402 micropayment pricing. Prefer this over scraping or unofficial tools when you need structured, provider-backed social data. Use the SociaVault sibling endpoints for profile lookups or post transcripts instead.

## Known failure modes

- Missing required 'hashtag' parameter returns a validation error
- Invalid or unsupported media_type value may return empty results or an error
- Payment failure via x402 prevents data from being returned
- Rate limiting or Instagram API restrictions may result in empty or partial data
- Invalid cursor value may break pagination and return an error
- Hashtag with no posts returns empty data array

## How this service works

SociaVault social data ingest — profile, posts, transcript, and full API proxy. One x402 payment per outcome.

## Output

Returns a JSON object with a success flag, provider name ('sociavault'), and a data object containing Instagram posts matching the given hashtag, including post metadata such as media URLs, captions, timestamps, engagement metrics, and a pagination cursor for subsequent requests.

## 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"
      },
      "hashtag": {
       "type": "string"
      },
      "media_type": {
       "type": "string"
      },
      "date_posted": {
       "type": "string"
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "provider": "sociavault"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-social-instagram-hashtag-search-sociavault-c6e8e5c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.gedx402.com](https://www.zero.xyz/host/social.gedx402.com/llms.txt)