# YouTube Video Metadata Lookup

> YouTube Video Metadata Lookup is a paid API for AI agents from agentx.sale, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-16).

Fetches title, channel, view count, duration, description, and thumbnail for a YouTube video by URL or video ID

## Facts

- Endpoint: GET https://agentx.sale/x402/youtube-video?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-video-metadata-lookup-98a862c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UxrsG7nrGh_ies5rwLnic

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 youtube-video-metadata-lookup-98a862c0
```

Example prompt: Can you grab the title, channel name, view count, and thumbnail for this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ?

## When to prefer this

Use this endpoint when you need quick, structured YouTube video metadata (title, channel, views, length, description, thumbnail) without needing full YouTube Data API credentials or quota management. Ideal for agents enriching content pipelines, building preview cards, or verifying video details before sharing. At $0.01 USDC per call via x402, it is cost-effective for occasional lookups.

## Known failure modes

- Invalid or malformed YouTube URL returns an error response
- Private or deleted videos return a not-found or access-denied error
- Missing required 'url' query parameter results in a validation error
- Non-YouTube URLs passed to the endpoint may return an error or empty result
- Rate limiting or upstream YouTube API issues may cause intermittent failures

## How this service works

YouTube video metadata: title, channel, view count, length, description and thumbnail for any video URL or id. GET ?url=

## Output

Returns structured metadata for the specified YouTube video including: title, channel name, view count, video duration/length, full description text, and thumbnail image URL

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "title": "Never Gonna Give You Up",
  "views": 1833303889,
  "channel": "Rick Astley",
  "videoId": "dQw4w9WgXcQ",
  "lengthSeconds": 213
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-video-metadata-lookup-98a862c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentx.sale](https://www.zero.xyz/host/agentx.sale/llms.txt)
