YouTube

YouTube data for agents: channel and playlist metadata, channel videos, search, autocomplete, comments, and video details via a third-party API.

GET/v1/youtube/search-autocomplete

https://api.vee3.io/v1/youtube/search-autocomplete

8 tokens

Get YouTube search query suggestions for a partial keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_search_autocomplete

Parameters3 fields

querystringRequired

Partial search keywords or phrase.

max length 512

languagestringOptional

Language code for localized suggestions (for example en).

Default: "en" · max length 10

locationstringOptional

Country code for localized suggestions (for example US).

Default: "US" · max length 10

Response3 fields

querystring

Normalized query echoed from the provider.

resultsarrayitems

1 field

Suggested search phrases for the query.

suggestionstring

Single autocomplete suggestion.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/search-autocomplete"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "despacito"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample autocomplete suggestions for despacito.

despacito_suggestions.json

{
  "query": "despacito",
  "results": [
    "despacito",
    "despacito justin bieber",
    "despacito lyrics",
    "despacito song",
    "despacito remix",
    "despacito slowed",
    "despacito dance",
    "despacito english version",
    "despacito karaoke",
    "despacito luis fonsi",
    "despacito piano",
    "despacito cover",
    "despacito 1 hour",
    "despacito guitar"
  ]
}

GET/v1/youtube/channel-details

https://api.vee3.io/v1/youtube/channel-details

10 tokens

Look up metadata for a public YouTube channel by id or URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_channel_details

Parameters1 field

channel_idstringRequired

YouTube channel id or URL (for example UCJ5v_MCY6GNUBTO8-D3XoAg or https://www.youtube.com/@WWE).

max length 2048

Response48 fields

channelIdstring

Canonical YouTube channel id.

titlestring

Channel display name.

usernamestring

Public @ handle when available.

descriptionstring

Channel About description.

joinedDatestring

Channel creation date (ISO 8601).

joinedDateTextstring

Human-readable join date.

countrystring

Country associated with the channel when available.

keywordsarrayitems

1 field

Channel keywords from the About page.

keywordstring

Single keyword string.

isVerifiedboolean

Whether the channel is verified.

isVerifiedArtistboolean

Whether the channel is a verified artist channel.

isFamilySafeboolean

Whether the channel is marked family safe.

hasBusinessEmailboolean

Whether a business email is available for contact.

artistBiostring

Artist bio text when the channel is a music artist.

canonicalBaseUrlstring

Canonical channel path on YouTube when available.

badgesarrayitems

2 fields

Channel badges (for example Official Artist Channel).

textstring

Badge label.

typestring

Badge type code.

avatararrayitems

3 fields

Channel avatar images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

bannerobject

12 fields

Channel banner images for desktop, mobile, and TV layouts.

desktoparrayitems

3 fields

Desktop banner images.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

mobilearrayitems

3 fields

Mobile banner images.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

tvarrayitems

3 fields

TV banner images.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

statsobject

5 fields

Public channel statistics.

subscribersinteger

Subscriber count.

subscribersTextstring

Formatted subscriber count.

videosinteger

Published video count.

videosTextstring

Formatted video count when available.

viewsinteger

Lifetime view count.

linksarrayitems

6 fields

External links listed on the channel About page.

titlestring

Link label shown on the channel About page.

targetUrlstring

Destination URL.

iconarrayitems

3 fields

Favicon images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_channel_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/channel-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "channel_id": "UCJ5v_MCY6GNUBTO8-D3XoAg"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample channel details for WWE.

wwe_channel.json

{
  "channelId": "UCJ5v_MCY6GNUBTO8-D3XoAg",
  "title": "WWE",
  "username": "@WWE",
  "description": "WWE on YouTube is your number one spot to catch WWE original shows and exclusives!",
  "joinedDate": "2007-05-10",
  "joinedDateText": "Joined May 10, 2007",
  "isVerified": false,
  "isVerifiedArtist": false,
  "isFamilySafe": true,
  "hasBusinessEmail": false,
  "stats": {
    "subscribers": 113000000,
    "subscribersText": "113M subscribers",
    "videos": 93965,
    "videosText": null,
    "views": 104597303944
  },
  "links": [
    {
      "title": "Where to Watch WWE",
      "targetUrl": "https://wwe.com/wheretowatch"
    }
  ]
}

GET/v1/youtube/channel-search

https://api.vee3.io/v1/youtube/channel-search

10 tokens

Search videos within a YouTube channel by keyword with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

search_youtube_channel

Parameters3 fields

channel_idstringRequired

YouTube channel id (for example UCJ5v_MCY6GNUBTO8-D3XoAg, not a URL).

max length 24

querystringRequired

Search keywords or phrase within the channel.

max length 512

cursorstringOptional

Pagination cursor from cursorNext.

max length 4096

Response18 fields

contentsarrayitems

16 fields

Matching video entries for the current page. Each entry includes a type field and nested video object.

typestring

Result entry type (for example video).

videoobject

14 fields

Video payload when type is video.

videoIdstring

Video id.

titlestring

Video title.

lengthSecondsinteger

Video duration in seconds.

publishedTimeTextstring

Human-readable publish age.

isLiveNowboolean

Whether the video is live.

badgesarrayitems

1 field

Video badges (for example CC, 4K).

badgestring

Badge label.

statsobject

1 field

View counts for the video.

viewsinteger

View count.

thumbnailsarrayitems

3 fields

Static thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

descriptionSnippetstring

Short description excerpt for the video.

cursorNextstring

Cursor for the next page, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_channel_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/channel-search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "channel_id": "UCJ5v_MCY6GNUBTO8-D3XoAg",
    "query": "john cena"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample channel search results for john cena on the WWE channel.

wwe_john_cena_results.json

{
  "contents": [
    {
      "type": "video",
      "video": {
        "badges": [
          "CC"
        ],
        "descriptionSnippet": "Watch the legendary battles and story between John Cena and Batista, starting with a tag team match in 2002...",
        "isLiveNow": false,
        "lengthSeconds": 3725,
        "publishedTimeText": "1 day ago",
        "stats": {
          "views": 227139
        },
        "thumbnails": [
          {
            "height": 94,
            "url": "https://i.ytimg.com/vi/-m9HMCvo1Dg/hqdefault.jpg",
            "width": 168
          }
        ],
        "title": "John Cena vs. Batista – full rivalry history: WWE Playlist",
        "videoId": "-m9HMCvo1Dg"
      }
    }
  ],
  "cursorNext": "4qmFsgJ5EhhVQ0o1dl9NQ1k2R05VQlRPOC1EM1hvQWcaJkNCNFNCbk5sWVhKamFEQUJPQUZnQVdvQWVnTkhRalM0QVFBJTNEWglqb2huIGNlbmGaAilicm93c2UtZmVlZFVDSjV2X01DWTZHTlVCVE84LUQzWG9BZ3NlYXJjaA%3D%3D"
}

GET/v1/youtube/channel-videos

https://api.vee3.io/v1/youtube/channel-videos

10 tokens

Fetch paginated videos from a public YouTube channel.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_channel_videos

Parameters2 fields

channel_idstringRequired

YouTube channel id (for example UCg6gPGh8HU2U01vaFCAsvmQ, not a URL).

max length 24

cursorstringOptional

Pagination cursor from a previous response cursor field.

max length 4096

Response19 fields

videosarrayitems

17 fields

Channel videos for the current page.

video_idstring

Video id.

titlestring

Video title.

authorstring

Channel display name.

number_of_viewsinteger

View count.

video_lengthstring

Video duration (for example 17:19).

descriptionstring

Video description when available.

is_live_contentstring

Whether the video is live content when available.

published_timestring

Human-readable publish time.

channel_idstring

Uploader channel id.

categorystring

Primary category label when available.

typestring

Video type (for example NORMAL).

keywordsarrayitems

1 field

Video keyword tags.

keywordstring

Single keyword tag.

thumbnailsarrayitems

3 fields

Video thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

cursorstring

Cursor for the next page, when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_channel_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/channel-videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "channel_id": "UCg6gPGh8HU2U01vaFCAsvmQ"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample channel videos page.

chris_titus_tech_videos_page.json

{
  "videos": [
    {
      "video_id": "xMv10E561WQ",
      "title": "The Ultimate Website Set Up",
      "author": "Chris Titus Tech",
      "number_of_views": 12033,
      "video_length": "17:19",
      "published_time": "1 day ago",
      "channel_id": "UCg6gPGh8HU2U01vaFCAsvmQ",
      "type": "NORMAL",
      "keywords": [],
      "thumbnails": [
        {
          "height": 94,
          "url": "https://i.ytimg.com/vi/xMv10E561WQ/hqdefault.jpg",
          "width": 168
        }
      ]
    }
  ],
  "cursor": "4qmFsgKnARIYVUNnNmdQR2g4SFUyVTAxdmFGQ0Fzdm1R..."
}

GET/v1/youtube/playlist-details

https://api.vee3.io/v1/youtube/playlist-details

10 tokens

Look up metadata for a public YouTube playlist by id.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_playlist_details

Parameters1 field

playlist_idstringRequired

YouTube playlist id (for example PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr).

max length 512

Response22 fields

playlistIdstring

Canonical YouTube playlist id.

titlestring

Playlist title.

descriptionstring

Playlist description.

updatedTimestring

Last update date (ISO 8601).

updatedTimeTextstring

Human-readable last update time.

badgesarrayitems

1 field

Playlist badges when available.

badgestring

Badge label.

authorobject

7 fields

Playlist creator summary.

titlestring

Playlist creator display name.

channelIdstring

Creator channel id.

canonicalBaseUrlstring

Canonical channel path on YouTube when available.

avatararrayitems

3 fields

Creator avatar images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

statsobject

2 fields

Public playlist statistics.

videosinteger

Number of videos in the playlist.

viewsinteger

Total playlist view count.

thumbnailsarrayitems

3 fields

Playlist thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_playlist_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/playlist-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "playlist_id": "PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample playlist details for Today's Hits Clean 2022.

todays_hits_clean_playlist.json

{
  "playlistId": "PLcirGkCPmbmFeQ1sm4wFciF03D_EroIfr",
  "title": "Today's Hits Clean 2022 - Clean Songs Playlist  - Clean Music 2022",
  "description": "Today's Hits Clean 2022 - Clean Songs Playlist  - Clean Music 2022",
  "updatedTime": "2022-06-21",
  "updatedTimeText": "Updated Jun 21, 2022",
  "badges": [],
  "author": {
    "title": "Roses are Red",
    "channelId": "UC6LgzwM4TqzlkX5AuwOe-ag",
    "canonicalBaseUrl": "/channel/UC6LgzwM4TqzlkX5AuwOe-ag",
    "avatar": [
      {
        "height": 48,
        "url": "https://yt3.ggpht.com/example=s48-c-k-c0x00ffffff-no-rj",
        "width": 48
      }
    ]
  },
  "stats": {
    "videos": 100,
    "views": 76877178
  },
  "thumbnails": [
    {
      "height": 94,
      "url": "https://i.ytimg.com/vi/mRD0-GxqHVo/hqdefault.jpg",
      "width": 168
    }
  ]
}

GET/v1/youtube/video-details

https://api.vee3.io/v1/youtube/video-details

10 tokens

Look up metadata for a public YouTube video by id or URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_video_details

Parameters1 field

video_idstringRequired

YouTube video id or URL (for example PuQFESk0BrA, https://youtu.be/PuQFESk0BrA, or https://www.youtube.com/watch?v=PuQFESk0BrA).

max length 2048

Response17 fields

video_idstring

Canonical YouTube video id.

titlestring

Video title.

authorstring

Channel display name.

number_of_viewsinteger

Total view count.

video_lengthstring

Video duration in seconds as a string.

descriptionstring

Plain-text video description.

is_live_contentstring

Whether the video is live content (True or False as a string).

published_timestring

Publish date (ISO 8601).

channel_idstring

Uploader channel id.

categorystring

Primary category label.

typestring

Video type (for example NORMAL).

keywordsarrayitems

1 field

Video keyword tags.

keywordstring

Single keyword tag.

thumbnailsarrayitems

3 fields

Available thumbnail images at different sizes.

heightinteger

Image height in pixels.

widthinteger

Image width in pixels.

urlstring

Image URL.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_video_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/video-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "PuQFESk0BrA"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample video details for a YMH podcast episode.

ymh_podcast.json

{
  "video_id": "PuQFESk0BrA",
  "title": "Your Mom's House Podcast - Ep. 488 w/ Bert Kreischer",
  "author": "YMH Studios",
  "number_of_views": 1979639,
  "video_length": "7456",
  "description": "Woah Mommies, it's a very special week so pull those jeans up.",
  "is_live_content": "False",
  "published_time": "2019-02-27",
  "channel_id": "UCYIgiXwJck_Pb5Nj-wIrsqg",
  "category": "Comedy",
  "type": "NORMAL",
  "keywords": [
    "ymh",
    "your mom's house",
    "tom segura"
  ],
  "thumbnails": [
    {
      "url": "https://i.ytimg.com/vi/PuQFESk0BrA/hqdefault.jpg",
      "width": 168,
      "height": 94
    }
  ]
}

GET/v1/youtube/video-comments

https://api.vee3.io/v1/youtube/video-comments

15 tokens

Fetch top-level comments for a YouTube video with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_video_comments

Parameters3 fields

video_idstringRequired

YouTube video id (11 characters, not a URL).

max length 11

cursorstringOptional

Pagination cursor from a previous response cursorNext field.

max length 4096

sort_bystringOptional

Comment sort order. One of: Top comments, Newest first.

max length 128

Response21 fields

commentsarrayitems

18 fields

Top-level comments for the current page and sort order. Additional provider-specific fields may appear on each entry.

commentIdstring

Comment id.

contentstring

Comment text.

publishedTimeTextstring

Human-readable comment age.

creatorHeartboolean

Whether the video creator hearted this comment.

cursorRepliesstring

Pagination cursor for fetching replies to this comment.

authorobject

6 fields

Comment author profile summary.

channelIdstring

Comment author channel id.

titlestring

Comment author display name.

isChannelOwnerboolean

Whether the author owns the video channel.

badgesarrayitems

2 fields

Author badges (for example Verified).

textstring

Badge label.

typestring

Badge type code.

statsobject

2 fields

Engagement counts for the comment.

repliesinteger

Reply count.

votesinteger

Like/vote count.

pinnedobject

2 fields

Pinned comment status.

statusboolean

Whether the comment is pinned.

textstring

Pinned label text when present.

cursorNextstring

Cursor for the next comments page, when available.

totalCommentsCountinteger

Total number of comments on the video.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_video_not_found, youtube_video_comments_sort_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/video-comments"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "kJQP7kiw5Fk"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample comments page with pagination cursor.

despacito_comments.json

{
  "comments": [
    {
      "commentId": "UgwW1S95-KHLW2bUI-14AaABAg",
      "content": "2017: People came to listen song.",
      "publishedTimeText": "1 year ago",
      "creatorHeart": false,
      "cursorReplies": "Eg0SC2tKUVA3a2l3NUZr...",
      "author": {
        "channelId": "UC9Hq2JZT1aKlG8nJqd7CB-A",
        "title": "Armaan singh",
        "isChannelOwner": false
      },
      "stats": {
        "replies": 496,
        "votes": 414947
      },
      "pinned": {
        "status": false,
        "text": null
      }
    }
  ],
  "cursorNext": "Eg0SC2tKUVA3a2l3NUZr...",
  "totalCommentsCount": 4202978
}

GET/v1/youtube/search

https://api.vee3.io/v1/youtube/search

20 tokens

Search YouTube for videos and other content with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

search_youtube

Parameters9 fields

querystringRequired

Search keywords or phrase.

max length 512

cursorstringOptional

Pagination cursor from cursorNext.

max length 4096

languagestringOptional

Language code for localized results (for example en).

Default: "en" · max length 10

locationstringOptional

Country code for localized results (for example US).

Default: "US" · max length 10

upload_datestringOptional

Upload date filter. One of: Last hour, Today, This week, This month, This year.

max length 128

content_typestringOptional

Content type filter. One of: Video, Channel, Playlist, Movie.

max length 128

durationstringOptional

Duration filter. One of: Under 4 minutes, 4 - 20 minutes, Over 20 minutes.

max length 128

featuresarrayOptional

Feature filters. Multiple allowed. Each value must be one of: Live, 4K, HD, Subtitles/CC, Creative Commons, 360°, VR180, 3D, HDR, Location, Purchased.

max 6

sort_bystringOptional

Sort order. One of: Relevance, Upload date, View count, Rating.

max length 128

Response22 fields

contentsarrayitems

18 fields

Search result entries for the current page. Video entries include a type field and nested video object.

typestring

Result entry type (for example video).

videoobject

16 fields

Video payload when type is video.

videoIdstring

Video id.

titlestring

Video title.

lengthSecondsinteger

Video duration in seconds.

publishedTimeTextstring

Human-readable publish age.

isLiveNowboolean

Whether the video is live.

authorobject

4 fields

Video author summary (avatar omitted).

titlestring

Channel or creator display name.

badgesarrayitems

2 fields

Author badges (for example Official Artist Channel).

textstring

Badge label.

typestring

Badge type code.

statsobject

1 field

View counts for the video.

viewsinteger

View count.

thumbnailsarrayitems

3 fields

Thumbnail images for the video.

urlstring

Thumbnail image URL.

widthinteger

Thumbnail width in pixels.

heightinteger

Thumbnail height in pixels.

cursorNextstring

Cursor for the next results page, when available.

estimatedResultsinteger

Approximate total number of matching results.

didYouMeanstring

Suggested corrected query when the search may be misspelled.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_not_configured, youtube_upstream_error, youtube_search_filter_not_found

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "despacito"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Default search results with pagination cursor.

despacito_results.json

{
  "contents": [
    {
      "type": "video",
      "video": {
        "videoId": "kJQP7kiw5Fk",
        "title": "Luis Fonsi - Despacito ft. Daddy Yankee",
        "lengthSeconds": 282,
        "publishedTimeText": "5 years ago",
        "isLiveNow": false,
        "author": {
          "channelId": "UCxoq-PAQeAdk_zyg8YS0JqA",
          "title": "Luis Fonsi"
        },
        "stats": {
          "views": 7870471715
        },
        "thumbnails": [
          {
            "height": 94,
            "url": "https://i.ytimg.com/vi/kJQP7kiw5Fk/hqdefault.jpg",
            "width": 168
          }
        ]
      }
    }
  ],
  "cursorNext": "EpgDEglkZXNwYWNpdG8aigNTQlNDQVF0...",
  "estimatedResults": 24852366,
  "didYouMean": null
}