# YouTube Channel Public Info by Handle

> YouTube Channel Public Info by Handle is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches public YouTube channel details (ID, name, description, subscriber count, video count) by channel handle

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/youtube-channel?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-channel-public-info-by-handle-fcd336b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1j0EbiEf2Zu3JiRAEKTur

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-channel-public-info-by-handle-fcd336b5
```

Example prompt: Can you look up the YouTube channel stats for the handle MrBeast — I want to know their subscriber count, video count, and channel ID?

## When to prefer this

Use this endpoint when you need quick public YouTube channel metadata (subscriber count, video count, channel ID) by handle without requiring a YouTube Data API key or quota. Prefer it for lightweight lookups of public channel stats. Not suitable for per-video statistics, private channels, or exact subscriber counts.

## Known failure modes

- Invalid or non-existent handle returns an error or empty result
- YouTube page structure changes may break scraping
- Description is truncated by YouTube to preview length
- Subscriber count is rounded as YouTube displays it, not exact
- Rate limiting or blocking from YouTube may cause failures

## How this service works

YouTube channel public details by @handle from the channel page: channel id, name, description (YouTube truncates it), subscriber count as YouTube rounds it (e.g. 44.7 million) and exact video count. Public page data; English locale; no per-video stats.

## Output

Returns a JSON object with the channel's YouTube ID, display name, handle, truncated description, rounded subscriber text (e.g. '44.7 million subscribers'), exact video count, source URL, and the timestamp when the data was checked.

## 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": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "description": "Channel handle without @, e.g. TED"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "TED",
  "handle": "TED",
  "source": "https://www.youtube.com/@TED?hl=en&gl=US",
  "channelId": "UCAuUUnT6oDeKwE6v1NGQxug",
  "checkedAt": "2026-10-23T09:35:27.437Z",
  "videoCount": 272526,
  "description": "The TED Talks channel features the best talks and performances from the TED Conference, where the world's leading thinkers and doers give the talk of their l...",
  "subscribersText": "44.7 million subscribers"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-channel-public-info-by-handle-fcd336b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)