# SocialFetch YouTube Video Fetcher

> SocialFetch YouTube Video Fetcher is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-16).

Fetches metadata and details for a single YouTube video given its URL, including support for Shorts URLs.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/youtube/videos
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-youtube-video-fetcher-674dbf77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m9bmR_3aHOoCks_3TMLYO

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 socialfetch-youtube-video-fetcher-674dbf77
```

Example prompt: Can you pull up all the details for this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — and give me the title, description, and channel info?

## When to prefer this

Use this endpoint when you need to programmatically retrieve metadata or details for a specific YouTube video by its URL, including YouTube Shorts. Prefer this over general web scraping when you want structured, reliable video data from YouTube in a pay-per-call model without managing your own scraping infrastructure.

## Known failure modes

- Invalid or malformed YouTube URL returns an error
- Video is private or deleted and cannot be fetched
- Rate limiting or quota exceeded for the API
- YouTube blocks or changes its structure causing fetch failures
- Unsupported URL format (non-YouTube URLs) returns an error

## How this service works

Get a single YouTube video by URL.

## Output

Returns structured metadata for the specified YouTube video, including details such as title, description, channel, view counts, publication date, and other available video attributes. Supports both standard YouTube URLs and Shorts URLs.

## 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",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Link to the YouTube video. Shorts URLs are also supported."
      },
      "language": {
       "type": "string",
       "maxLength": 16,
       "minLength": 2,
       "description": "Optional preferred language for returned text when the source supports localization."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-youtube-video-fetcher-674dbf77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)
