A channel’s profile and about info by ID, @handle or URL: description, subscriber count (rounded by YouTube), exact total views and video count, country, join date, verification, images and links. An unknown or terminated channel is a 404, never an empty record.

POST /channel Videos and channels

https://api.fetchlayer.dev/youtube/channel

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

channel string required

A YouTube channel ID (starts with UC), @handle (e.g. @MrBeast) or channel URL.

format string optional

json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)

Response Fields

channel

Get YouTube channel details

entityType string

Always youtube-channel.

channelId string

The channel ID (starts with UC).

handle string | null

The @handle, or null when the channel has none.

url string

The channel URL.

title string

The channel name.

description string

The about text.

country string | null

The country as the channel shows it; null when it sets none.

joinedDate string | null

When the channel was created (YYYY-MM-DD).

subscriberCount integer | null

Approximate: YouTube rounds public subscriber counts to three significant figures. Null when the channel hides it.

subscriberCountText string | null

The rounded count as YouTube displays it, e.g. "4.55M subscribers".

viewCount integer | null

Exact total views.

videoCount integer | null

Exact number of videos.

isVerified boolean

Whether the channel is verified.

isOfficialArtist boolean

Whether it is an official artist channel.

isFamilySafe boolean | null

Marked suitable for all audiences; null when not known.

keywords string[]

The channel’s keywords; [] when none.

avatar object[]

Avatar images, each with url, width and height.

banner object[]

Banner images, each with url, width and height.

links object[]

External links on the channel, each with title and url.

notes string[]

Caveats about this result; [] when none.

scrapedAt string

When the result was produced (ISO 8601).

Request

curl -X POST "https://api.fetchlayer.dev/youtube/channel" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"channel":"@MrBeast"}'

import { FetchLayer } from '@fetchlayer/youtube';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.channel({
  "channel": "@MrBeast"
});

Response

{
  "entityType": "youtube-channel",
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "handle": "@MrBeast",
  "url": "https://www.youtube.com/@MrBeast",
  "title": "MrBeast",
  "country": "United States",
  "joinedDate": "2012-02-19",
  "subscriberCount": 522000000,
  "subscriberCountText": "522M subscribers",
  "viewCount": 143700252369,
  "videoCount": 1008,
  "isVerified": true,
  "isOfficialArtist": false,
  "isFamilySafe": true,
  "keywords": [
    "mrbeast6000",
    "beast",
    "mrbeast"
  ],
  "links": [
    {
      "title": "Follow",
      "url": "https://www.instagram.com/mrbeast/"
    }
  ],
  "notes": []
}

{
  "error": "Invalid API key"
}