POST
/
youtube
/
channel
/
curl --request POST \
  --url https://api.gurubase.io/api/v1/youtube/channel/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "url": "<string>"
}'
{
    "channel_identifier": {identifier},
    "identifier_type": "username",
    "video_count": 3,
    "videos": [
        {url1},
        {url2},
        {url3}
    ]
}

This endpoint allows you to fetch the list of all uploaded videos from a YouTube channel URL. The operation is synchronous and returns the list directly in the response.

To be able to use this feature on self-hosted, you need to specify your YouTube API Key in the settings page. You can create one by following the instructions here. After this, you also need to enable the “Youtube Data API v3” API in your Google Cloud project.

​
Body Parameters

​
url
string
required

The YouTube channel URL to fetch data from. Must be a valid YouTube channel URL.

The allowed formats look like these:

  • youtube.com/channel/{channel_id}
  • youtube.com/@{user_handler}

​
Response

​
channel_identifier
string

Identifier used to find the channel. Can be either the id or the handler of the channel.

​
identifier_type
string

Identifier type used to find the channel. Can be either “channel_id” or “username”

​
video_count
int

The number of videos in the channel

​
videos
list

The urls of the videos

{
    "channel_identifier": {identifier},
    "identifier_type": "username",
    "video_count": 3,
    "videos": [
        {url1},
        {url2},
        {url3}
    ]
}