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"]
}
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
Parameter | Type | Required | Description |
---|---|---|---|
id | string | Yes | YouTube channel URL, handle or ID. See Supported YouTube URL Formats. |
limit | number | No | Maximum number of video IDs to return. If type = all , vertical videos are prioritized. (Default: 30, Max: 5000) |
type | enum | No | all , video , short (Default: all ) |
When fetching type: all
, the limit parameter applies to vertical videos first. 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
}
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:
- Get metadata for each video using the Video Metadata endpoint
- 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