# YouTube Thumbnail Expander

> YouTube Thumbnail Expander is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-23).

Fetches and returns a full-resolution YouTube video thumbnail image URL along with its dimensions

## Facts

- Endpoint: POST https://x402.agentutility.ai/youtube-thumbnail-expand?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-thumbnail-expander-e9767666
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jSetMWjGBDm5yxGUyq-tj

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-thumbnail-expander-e9767666 -d '<json body>'
```

Example prompt: Can you get me the full-resolution thumbnail image URL, width, and height for this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ?

## When to prefer this

Use this endpoint when you need to programmatically resolve a YouTube video's thumbnail image URL and dimensions from a video URL or ID, especially in agent workflows that need to display or process video preview images. Prefer this over manual construction of YouTube thumbnail URLs when you need verified dimensions and a confirmed accessible URL.

## Known failure modes

- Invalid or malformed YouTube URL/ID returns an error response
- Video is private or deleted — thumbnail may not be available
- YouTube CDN changes may cause stale or broken image URLs
- Rate limits or upstream YouTube access issues causing fetch failure

## How this service works

817 pay-per-call APIs for AI agents. Every endpoint is POST /<name> and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON.

## Output

Returns a JSON object with the resolved thumbnail image URL (e.g. a high-res PNG hosted on YouTube's CDN), plus the width (e.g. 1280) and height (e.g. 720) of the thumbnail image.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "image_url",
      "canvas_width",
      "canvas_height"
     ],
     "properties": {
      "seed": {
       "type": "number",
       "description": "Random seed for reproducible output. Optional; random if omitted."
      },
      "prompt": {
       "type": "string",
       "description": "Text hint describing what to generate in the expanded area. Optional."
      },
      "image_url": {
       "type": "string",
       "description": "Source image URL to expand."
      },
      "original_x": {
       "type": "number",
       "description": "X offset of the original image within the new canvas. Optional; must pair with original_y."
      },
      "original_y": {
       "type": "number",
       "description": "Y offset of the original image within the new canvas. Optional; must pair with original_x."
      },
      "canvas_width": {
       "type": "number",
       "description": "Target canvas width in pixels. 256-4096."
      },
      "canvas_height": {
       "type": "number",
       "description": "Target canvas height in pixels. 256-4096."
      },
      "original_width": {
       "type": "number",
       "description": "Width of the original image within the new canvas. Optional; must pair with original_height."
      },
      "original_height": {
       "type": "number",
       "description": "Height of the original image within the new canvas. Optional; must pair with original_width."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "width": {
       "type": "integer"
      },
      "height": {
       "type": "integer"
      },
      "image_url": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "width": 1280,
  "height": 720,
  "image_url": "https://...png"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-thumbnail-expander-e9767666/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)