# StableSocial YouTube Search

> StableSocial YouTube Search is a paid API for AI agents from stablesocial.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Search YouTube for videos, shorts, channels, or playlists by keyword with optional filters for region, sort order, duration, and upload date

## Facts

- Endpoint: POST https://stablesocial.dev/api/sc/youtube/search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-youtube-search-25bcd253
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VwaKTkBa6eQLhJGBpjEJf

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 stablesocial-youtube-search-25bcd253 -d '<json body>'
```

Example prompt: Search YouTube for videos about 'electric vehicle reviews' uploaded this month, sorted by popularity, and include like and comment counts — I want videos only, not shorts or channels.

## When to prefer this

Use this endpoint when you need programmatic, pay-per-request YouTube search without managing API keys or OAuth. It is ideal for agents that need to discover YouTube content on demand, perform trend research, or build content pipelines without committing to a subscription. Prefer this over the YouTube Data API when you want zero-auth simplicity, need residential proxy routing via region codes, or want to avoid quota management.

## Known failure modes

- Empty results if the query returns no matches for the given filters
- Invalid region code returns an error or falls back to default region
- Expired or invalid continuationToken causes pagination to fail
- Duration filter ignored when searching shorts (only applies to videos)
- Rate-limited or blocked by YouTube, returning incomplete or empty results
- Missing required 'query' field returns a validation error

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

Returns a list of YouTube search results matching the query, typed by the requested content category (videos, shorts, channels, or playlists). Each result includes title, URL, thumbnail, channel info, view count, and publish date. When includeExtras is set, results also include like count, comment count, and description. A continuationToken is provided to fetch the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "videos",
    "shorts",
    "channels",
    "playlists"
   ],
   "type": "string",
   "description": "Type of content to search for"
  },
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Search query"
  },
  "region": {
   "type": "string",
   "description": "2 letter country code of the country to put the proxy in."
  },
  "sortBy": {
   "enum": [
    "relevance",
    "popular"
   ],
   "type": "string",
   "description": "Sort by"
  },
  "duration": {
   "enum": [
    "under_3_min",
    "between_3_and_20_min",
    "over_20_min"
   ],
   "type": "string",
   "description": "Duration of the video. Only applies to videos (not shorts)."
  },
  "uploadDate": {
   "enum": [
    "today",
    "this_week",
    "this_month",
    "this_year"
   ],
   "type": "string",
   "description": "Upload date"
  },
  "includeExtras": {
   "type": "string",
   "description": "This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down t"
  },
  "continuationToken": {
   "type": "string",
   "description": "Continuation token to get more videos. Get 'continuationToken' from previous response."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-youtube-search-25bcd253/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)