# agdata YouTube Search & Channel Profile

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

Search YouTube videos by keyword or fetch a channel's recent videos, returning normalized metadata per video including title, views, likes, duration, and channel info.

## Facts

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

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-channel-profile-3b65db1a -d '<json body>'
```

Example prompt: Search YouTube for the top 10 videos about 'prompt engineering' and give me the title, view count, and duration for each one.

## When to prefer this

Use this endpoint when you need structured YouTube video metadata (views, likes, duration, channel stats) without managing YouTube Data API quotas or authentication. Best for keyword-based video discovery or fetching a specific channel's recent uploads at $0.028 per call. Prefer this over the YouTube Data API when you want pay-per-use pricing with no API key setup.

## Known failure modes

- Channel handle not found — returns empty array or error if the channel doesn't exist
- Query returns no results — possible for very niche keywords
- Limit out of range — clamped to 1-20 silently or returns error
- Payment failure — x402 payment not accepted, request blocked
- Rate limiting or scraping block — YouTube anti-bot measures may cause intermittent failures

## How this service works

YouTube video search by keyword, or the videos of one channel. Mode search takes keywords; mode profile takes a channel handle without the @. limit is 1-20 regular videos, no Shorts or live streams. Per video you get a normalized object: title, description, views, likes, comments_count, duration_seconds, published_at, thumbnail, url, channel_name, channel_url, channel_id, subscribers.

## Output

A JSON array of up to 20 video objects, each containing: title, description, views, likes, comments_count, duration_seconds, published_at, thumbnail URL, video URL, channel_name, channel_url, channel_id, and subscriber count. Shorts and live streams are excluded.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "search"
   ],
   "type": "string",
   "description": "profile=channel's videos, search=keyword→videos"
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "max results returned (clamped to this range)"
  },
  "query": {
   "type": "string",
   "description": "channel handle without @ (profile) or search keywords"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-youtube-search-channel-profile-3b65db1a/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)