Get channels details

GET

channels

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ids

string

An array of channel IDs to retrieve data for. Each ID should be a valid channel ID.

forHandle

string

The unique channel handle of the channel for which you want to retrieve data.

forUsername

string

The unique channel username of the channel for which you want to retrieve data. This is the legacy username format.

enum<string>

The language to retrieve localized data in. If not specified, the default language will be used.

Available options:

en,

es,

de,

fr,

ja,

pt,

tr,

it,

fa,

nl,

af,

am,

ar,

as,

az,

be,

bg,

bn,

bs,

ca,

cs,

da,

el,

en-GB,

en-IN,

es-419,

es-US,

et,

eu,

fi,

fil,

fr-CA,

gl,

gu,

hi,

hr,

hu,

hy,

id,

is,

iw,

ka,

kk,

km,

kn,

ko,

ky,

lo,

lt,

lv,

mk,

ml,

mn,

mr,

ms,

my,

no,

ne,

or,

pa,

pl,

pt-PT,

ro,

ru,

si,

sk,

sl,

sq,

sr-Latn,

sr,

sv,

sw,

ta,

te,

th,

uk,

ur,

uz,

vi,

zh-CN,

zh-HK,

zh-TW,

zu

fields

string

An array of fields to include in the response. If not provided, all fields will be returned.

Response

200 - application/json

totalResults

number

required

Total number of channels returned

data

object[]

required

Array of channel objects

data.id

string

required

The unique identifier for the YouTube channel

data.title

string

The channel's title

data.description

string

The channel's description

data.keywords

string

Comma-separated keywords associated with the channel

data.unsubscribedTrailer

string

The ID of the channel's trailer video for unsubscribed viewers

data.country

string

The country where the channel is based

data.customUrl

string

The custom URL of the channel, if set

data.publishedAt

string

The date and time when the channel was created (ISO 8601 format)

data.viewCount

string

The number of times the channel has been viewed

data.subscriberCount

string

The number of subscribers the channel has

data.hiddenSubscriberCount

boolean

Indicates if the channel's subscriber count is publicly visible

data.videoCount

string

The number of public videos uploaded to the channel

data.topicIds

string[]

A list of topic IDs associated with the channel

data.topicCategories

string[]

A list of topic categories associated with the channel

data.privacyStatus

string

The privacy status of the channel (e.g., "public", "private", "unlisted")

data.isLinked

boolean

Indicates if the channel is linked to either a YouTube content owner or a YouTube user

data.longUploadsStatus

string

The status of the channel for featuring longer videos

data.madeForKids

boolean

Indicates if the channel is designated as child-directed and complies with the Children's Online Privacy Protection Act (COPPA)

data.bannerExternalUrl

string

The URL of the banner image shown on the channel page on desktop

data.thumbnailUrl

string

The URL of the channel's thumbnail image

data.thumbnails

object

An object containing thumbnail images for the channel in different sizes

Get batch channels Get videos details

API Documentation

Search

Batch

Details

General

Files

Authorizations

Query Parameters

Response