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"]
}
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. Default: 30. Max: 5000 |
Response Format
{
"videoIds": string[] // List of YouTube 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:
- 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