​
Quick Start

​
Request

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

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

const channelVideos: VideoIds = await supadata.youtube.channel.videos({
  id: 'https://youtube.com/@RickAstleyVEVO', // can be url, channel id, handle
  type: 'all', // 'video', 'short', 'live', 'all'
  limit: 10,
});

​
Response

{
  "videoIds": ["dQw4w9WgXcQ", "xvFZjo5PgG0"],
  "shortIds": ["xvFZjo5PgG0", "dQw4w9WgXcQ"],
  "liveIds": ["dQw4w9WgXcQ", "xvFZjo5PgG0"]
}

​
Specification

​
Endpoint

GET https://api.supadata.ai/v1/youtube/channel/videos 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.
limitnumberNoMaximum number of video IDs to return. If type = all, vertical videos are prioritized. (Default: 30, Max: 5000)
typeenumNoall, video, short, live (Default: all)
When fetching type: all, the limit parameter applies to vertical videos first, then Shorts and live videos. For example, if the channel has 100 vertical videos and 100 Shorts, and limit is 150, then 100 vertical videos and 50 Shorts will be returned.

​
Response Format

{
  "videoIds": string[], // List of vertical YouTube video IDs
  "shortIds": string[], // List of Shorts IDs
  "liveIds": string[] // List of live video IDs
}

​
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.

​
Working with Channel Videos

After retrieving the list of video IDs, you can:
  1. Get metadata for each video using the Video Metadata endpoint
  2. Get transcripts for each video using the Transcript endpoint
Videos are returned latest first, just like in the “Videos” tab of a YouTube channel.

​
Pricing

  • 1 channel videos request = 1 credit