Skip to Content
DocumentationYoutubeChannel Videos

Get Channel Videos

This endpoint returns a list of video IDs from a YouTube channel.

Quick Start

Request

curl -X GET 'https://api.supadata.ai/v1/youtube/channel/videos?id=RickAstleyVEVO&limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

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. Find out more about Authentication.

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
PlaylistPlaylist Videos