GET
/
youtube
/
channel
import { Supadata } from '@supadata/js';

const supadata = new Supadata({
  apiKey: 'YOUR_API_KEY',
});
const channel = await supadata.youtube.channel({
  id: 'RickAstleyVEVO', // can be url, id, handle
});
console.log(channel.name);
{
  "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "name": "Rick Astley",
  "description": "The official Rick Astley YouTube channel",
  "subscriberCount": 2000000,
  "videoCount": 100,
  "thumbnail": "https://yt3.ggpht.com/...",
  "banner": "https://yt3.ggpht.com/..."
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
id
string
required

YouTube channel URL, handle or ID. See supported URL formats.

Examples:

"https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw"

"https://youtube.com/c/rickastley"

"UCuAXFkgsw1L7xaCfnd5JJOw"

"@rickastley"

"rickastley"

Response

Successfully fetched channel metadata

​
id
string
required

YouTube channel ID

Example:

"UCuAXFkgsw1L7xaCfnd5JJOw"

​
name
string
required

Channel name

Example:

"Rick Astley"

​
description
string

Channel description

Example:

"The official Rick Astley YouTube channel"

​
subscriberCount
number

Number of subscribers

Example:

2000000

​
videoCount
number

Number of videos on the channel

Example:

100

​
thumbnail
string

URL to channel thumbnail

Example:

"https://yt3.ggpht.com/..."

​
banner
string

URL to channel banner

Example:

"https://yt3.ggpht.com/..."