​
Quick Start

​
Request

import {
  Supadata,
  YoutubeChannel
} from '@supadata/js';

// Initialize the client
const supadata = new Supadata({
  apiKey: 'YOUR_API_KEY',
});

const channel: YoutubeChannel = await supadata.youtube.channel({
  id: 'https://youtube.com/@RickAstleyVEVO', // can be url, channel id, handle
});

​
Response

{
  "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/..."
}

​
Specification

​
Endpoint

GET https://api.supadata.ai/v1/youtube/channel Each request requires an x-api-key header with your API key available after signing up. Get your API key here.

​
Query Parameters

ParameterTypeRequiredDescription
idstringYesYouTube channel URL, handle or ID. See Supported YouTube URL Formats.

​
Channel Videos

You can also retrieve a list of video IDs from a channel using the Channel Videos endpoint.

​
Error Codes

The API returns HTTP status codes and error codes. See this page for more details.

​
Supported YouTube Identifiers

The universal id parameter supports various YouTube URL and ID formats. See this page for more details.

​
Pricing

  • 1 channel metadata request = 1 credit