# GEDX402 Social – YouTube Search via SociaVault

> GEDX402 Social – YouTube Search via 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-09-14).

Search YouTube videos by query with filters for region, sort order, upload date, and pagination via a pay-per-call x402 proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/youtube/search
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-youtube-search-via-sociavault-7485ee7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VeOIyqV9WP8RzTcelu3eU

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-youtube-search-via-sociavault-7485ee7a
```

Example prompt: Search YouTube for videos about 'machine learning tutorials' uploaded this week, sorted by view count, in the US region — use SociaVault to get me the results.

## When to prefer this

Use this endpoint when you need programmatic YouTube search with filtering (region, upload date, sort order) and are operating in an x402 micropayment environment. Prefer it over scraping or the official YouTube Data API when you need a simple pay-per-call model without API key management.

## Known failure modes

- Payment not provided or invalid x402 payment — returns 402 Payment Required
- Invalid or missing query parameter — returns error or empty results
- Unsupported region or filter value — may return empty results or an error
- Expired or invalid continuationToken — pagination fails
- SociaVault upstream YouTube API unavailable — returns failure with success:false

## 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 'data' field containing YouTube search results (video listings, metadata), a 'success' boolean, and a 'provider' field confirming SociaVault. Pagination is supported via a continuationToken for subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "filter": {
   "type": "string"
  },
  "region": {
   "type": "string"
  },
  "sortBy": {
   "type": "string"
  },
  "uploadDate": {
   "type": "string"
  },
  "continuationToken": {
   "type": "string"
  }
 }
}
```

## 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-youtube-search-via-sociavault-7485ee7a/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)