Get channel

getChannel(id, query?, options?): Channel

GET/v1/channels/{id}1 Credit

Handles such as @MrBeast and 24-character channel IDs (UC...) are resolved automatically.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

id:string

Path param:

Channel handle (for example @MrBeast) or canonical channel ID.

required_country?:string

Query param:

ISO country hint used when region availability matters.

ReturnsExpand Collapse

channel_id:string

Canonical 24-character channel ID.

title:string

Channel display name.

handle:string

Public handle, including @.

description:string

Channel about text.

subscriber_count:number

Approximate subscriber count.

video_count:number

Public upload count.

verified:boolean

Whether the channel has a verified badge.

thumbnails:Thumbnail[]

Avatar images.

banners:Thumbnail[]

Banner images.

links:string[]

External links from the channel page.

available_tabs:string[]

Tabs that can be listed, such as videos, shorts, streams, and playlists.

Get channel

const response = await fetch("https://api.ytapi.dev/v1/channels/@MrBeast", {
  headers: {
    Authorization: `Bearer ${process.env.YT_API_KEY}`,
  },
});

const channel = await response.json();
console.log(channel.title, channel.subscriber_count);

curl -X GET "https://api.ytapi.dev/v1/channels/@MrBeast" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.ytapi.dev/v1/channels/@MrBeast", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

200 example

{
  "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "title": "MrBeast",
  "handle": "@MrBeast",
  "description": "SUBSCRIBE FOR A COOKIE! New video every single Saturday...",
  "subscriber_count": 517000000,
  "subscriber_count_text": "517M subscribers",
  "video_count": 1000,
  "verified": true,
  "custom_url": "http://www.youtube.com/@MrBeast",
  "country": "US",
  "thumbnails": [
    { "url": "https://yt3.googleusercontent.com/nxYrc_1_=s900", "width": 900, "height": 900 }
  ],
  "links": ["https://www.instagram.com/mrbeast/"],
  "available_tabs": ["videos", "shorts", "streams", "playlists"]
}