Skip to main content
GET
Get videos details

Authorizations

Authorization
string
header
required

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

Query Parameters

ids
string
required

An array of video IDs to retrieve data for.

hl
enum<string>

The language to retrieve localized data in.

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,
zh-Hans,
zu
fields
enum<string>

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

Available options:
id,
publishedAt,
channelId,
title,
description,
thumbnails,
channelTitle,
tags,
categoryId,
defaultLanguage,
defaultAudioLanguage,
viewCount,
likeCount,
commentCount,
topicCategories,
uploadStatus,
privacyStatus,
license,
embeddable,
publicStatsViewable,
madeForKids,
hasPaidProductPlacement,
localizations,
categoryTitle,
duration,
parsedDuration,
caption,
isShort
Example:

"id,title,viewCount,description"

include
enum<string>

A list of additional fields to include in the response.

Available options:
isShort
Example:

"isShort"

Response

Successful response

totalResults
number
required

Total number of video details returned.

data
object[]
required

Array of video detail objects.