POST
/
batch
/
videos

This endpoint allows you to retrieve multiple videos in a single request. Simply specify a list of video IDs, and the API will return the details of each video.

This request supports batch processing, allowing you to retrieve up to 1,000 videos in a single request.

Price

The cost of this request is based on the number of videos you request. The base cost of request is $0.00003, and each set of 50 videos costs $0.00001.

For example:

  • 1 video requires 1 quota
  • 50 videos requires 1 quota
  • 75 videos requires 2 quotas
  • 100 videos requires 2 quotas
  • 101 videos requires 3 quotas
  • 1000 videos requires 20 quotas.

Authorizations

Authorization
string
headerrequired

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

Query Parameters

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

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

Body

application/json
ids
string[]
required

An array of video IDs to retrieve data for.

includeLocalizations
boolean

Whether to include localized data.

Response

200 - application/json
totalResults
number
required

Total number of videos returned.

data
object[]
required

Array of video detail objects.