# agdata YouTube Search & Profile API

> agdata YouTube Search & Profile API is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.032/call, status unknown (last checked 2026-10-15).

Fetches structured YouTube video data by searching keywords or retrieving a channel's videos, returning rich metadata like views, likes, subscribers, and thumbnails.

## Facts

- Endpoint: POST https://agdata.shveik.dev/mpp/youtube?utm_source=zero.xyz
- Price: $0.032/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-youtube-search-profile-api-bd76a349
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4vd51Iz6riuS4yPcZhvog

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 agdata-youtube-search-profile-api-bd76a349 -d '<json body>'
```

Example prompt: Search YouTube for 'beginner Python tutorials' and give me the top 10 results with their titles, view counts, and channel names.

## When to prefer this

Choose this endpoint when you need structured YouTube video metadata (views, likes, subscribers, thumbnails) without setting up the official YouTube Data API, managing API keys, or handling proxy infrastructure. It's ideal for AI agents that need fresh YouTube data on demand, pay per call in stablecoins, and want results as clean JSON rather than raw HTML. Prefer it over the official YouTube API when you want zero-setup access or need to avoid quota limits.

## Known failure modes

- Invalid mode value (not 'profile' or 'search') returns a validation error
- Query string exceeding 500 characters is rejected
- Limit outside 1–20 range is rejected
- Channel not found returns empty results or 404-equivalent
- Payment failure (insufficient USDC balance or unsupported chain) blocks the request
- YouTube rate limiting or blocking on the backend may return partial or empty results
- Non-existent or private YouTube channel returns no data

## How this service works

Unblocking and fresh web data for AI agents. Social, maps, search, news, jobs and reviews as structured data, and unblocking for any other page, as Markdown or HTML. Pay per call in stablecoins over x402 or MPP, with no API key, no account and no proxy setup. (x402 on Base and Polygon (plus Solana on most routes) or MPP on Base)

## Output

Returns a JSON object (or array) with structured video metadata for each result, including: video ID, URL, title, description, thumbnail URL, view count, like count, comment count, duration in seconds, publish date, channel name, channel ID, channel URL, and subscriber count of the channel.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "search"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "QhD015WU…",
  "url": "https://…",
  "likes": 13000,
  "title": "Beginner…",
  "views": 483801,
  "thumbnail": "https://…",
  "channel_id": "UCZDA1kA…",
  "channel_url": "https://…",
  "description": "The web…",
  "subscribers": 627000,
  "channel_name": "Tinkernu…",
  "published_at": "2021-11-…",
  "comments_count": 232,
  "duration_seconds": 456
 }
}
```

## More

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