Vee3

YouTube channel details

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

← All YouTube endpoints · Capability overview

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