Skip to main content
POST
/
youtube
/
channel
Import 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}
    ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Headers

​
x-api-key
string
required
Your API key for authentication. You can obtain your API key from the Gurubase dashboard.

​
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}
    ]
}