# SocialFetch YouTube Channel Details

> SocialFetch YouTube Channel Details 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-14).

Retrieves detailed metadata for a YouTube channel given its channel ID, handle, or URL.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/youtube/channel
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-youtube-channel-details-11d62aca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_olUg7lkirAklN9jGLXgl7

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-channel-details-11d62aca
```

Example prompt: Can you pull up the channel details for the YouTube channel @mkbhd — I want to know things like their subscriber count, description, and channel ID.

## When to prefer this

Use this endpoint when you need to look up YouTube channel metadata by a known channel ID, @handle, or channel URL. Prefer this over manual scraping or the YouTube Data API when you want a simple, pay-per-call REST lookup without managing OAuth credentials or quota.

## Known failure modes

- Invalid or non-existent channel ID returns an error or empty result
- Malformed YouTube URL causes a parsing or validation error
- Channel handle not found returns 404 or empty response
- Missing required lookup parameter (no channelId, handle, or url provided) returns a validation error
- Private or deleted channel returns no data
- Rate limiting or quota exceeded returns a 429 error

## How this service works

Get YouTube channel details by channel id, handle, or URL.

## Output

Returns structured metadata about the YouTube channel, including details such as channel name, handle, channel ID, description, subscriber count, video count, and other profile statistics available from the channel's public data.

## 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",
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Optional YouTube channel URL for the request."
      },
      "handle": {
       "type": "string",
       "description": "Optional YouTube channel handle for the request."
      },
      "channelId": {
       "type": "string",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Optional YouTube channel id for the request."
      }
     }
    }
   },
   "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-channel-details-11d62aca/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)