Skip to main content
GET
/
files
/
captions
/
{videoId}
Get captions files list
curl --request GET \
  --url https://api.poix.io/files/captions/{videoId} \
  --header 'Authorization: Bearer <token>'
[
  {
    "languageCode": "en",
    "languageName": "English (auto-generated)",
    "isAutoGenerated": true,
    "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=json3"
  },
  {
    "languageCode": "en",
    "languageName": "English (auto-generated)",
    "isAutoGenerated": true,
    "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=srt"
  },
  {
    "languageCode": "en",
    "languageName": "English (auto-generated)",
    "isAutoGenerated": true,
    "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=vtt"
  },
  {
    "languageCode": "en",
    "languageName": "English (auto-generated)",
    "isAutoGenerated": true,
    "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=ttml"
  },
  {
    "languageCode": "en",
    "languageName": "English (auto-generated)",
    "isAutoGenerated": true,
    "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=srv1"
  }
]

Authorizations

Authorization
string
header
required

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

Path Parameters

videoId
string
required

The YouTube video ID

Required string length: 11
Example:

"dQw4w9WgXcQ"

Query Parameters

format
enum<string>

The format of the response

Available options:
json,
text,
csv
Example:

"json"

lang
string

The language code for the captions

Required string length: 2
Example:

"en"

Response

Successful response

languageCode
string
required

The language code of the caption

languageName
string
required

The language name of the caption

isAutoGenerated
boolean
required

Whether the caption is auto-generated

url
string<uri>
required

The URL of the caption file