Get video captions
This endpoint retrieves captions for a specified YouTube video. The captions can be returned in JSON, text, or CSV format. If available, it provides timing information, language, and speech rate data.
This endpoint retrieves a captions for a video.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The YouTube video ID. This is a unique 11-character string that YouTube uses to identify videos.
11"dQw4w9WgXcQ"
Query Parameters
The format of the response. If not specified, defaults to JSON. Use "text" for plain text output, "csv" for comma-separated values, "json" for structured data and "xml" for XML output.
json, text, csv, xml, srt, vtt, ttml, srv1, srv2, srv3, json3 "json"
The two-letter ISO 639-1 language code for the desired captions (e.g., "en" for English, "es" for Spanish). If not provided, the default language of the video's captions will be used.
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, en-US, zh-Hant, zh, yue "en"
The mode to use when fetching captions. The "default" will throw an error if captions are not available. The "fallback-whisper" will use the whisper API if the default captions are not available. The "force-whisper" will always use the whisper API.
default, fallback-whisper, force-whisper "default"
Response
Successful response. The format of the response depends on the "format" query parameter.
List of caption items. Each item represents a single caption with timing and speech information.
List of caption items. Each item represents a single caption with timing and speech information.
Plain text response containing all captions concatenated together
"[Music] we&#39;re no strangers to love you know the rules and so do I I full commitments while I&#39;m thinking of you wouldn&#39;t get this from any other guy I just want to tell you how I&#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you we&#39;ve known each other for so long your heart&#39;s been aching but your to sh to say it inside we both know what&#39;s been going on we know the game and we&#39;re going to playing and if you ask me how I&#39;m feeling don&#39;t tell me you&#39;re too my you see Never Going To Give You Up never going to let you down never to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you never going to give you up never going to let you down never going to run around and desert you never going to make you cry never going to sing goodbye going to tell a lie and hurt you give you give you going to give going to give you going to give going to give you we&#39;ve known each other for so long your heart&#39;s been aching but you&#39;re too sh to say inside we both know what&#39;s been going on we the game and we&#39;re going to play it I just want to tell you how I&#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell you my and Hurt You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you C never going to say goodbye never going to tell and Hur You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you going to [Music] goodbye and"
Comma-separated values response with headers for each caption property
"text,duration,offset,lang,wordCount,speechRate\n[Music],14.65,0,en,1,5\nwe&#39;re no strangers to,7.239,18.8,en,7,59\nlove you know the rules and so do,7.84,21.8,en,8,62\nI I full commitments while I&#39;m thinking,5.201,26.039,en,10,116\nof,5.88,29.64,en,1,11\nyou wouldn&#39;t get this from any other guy,8.2,31.24,en,11,81\nI just want to tell you how I&#39;m,7.84,35.52,en,11,85\nfeeling got to make you understand Never,6.759,39.44,en,7,63\nGoing To Give You Up never going to let,6.359,43.36,en,9,85\nyou down never going to run around and,7.441,46.199,en,8,65\ndesert you never going to make you cry,6.401,49.719,en,8,75\nnever going to say goodbye never going,7.12,53.64,en,7,59\nto tell a lie and hurt you,7.84,56.12,en,7,54\nwe&#39;ve known each other for so,6.56,60.76,en,9,83\nlong your heart&#39;s been aching but your,6.64,63.96,en,10,91\nto sh to say it inside we both know,5.2,67.32,en,9,104\nwhat&#39;s been going,6.04,70.6,en,6,60\non we know the game and we&#39;re going to,8.88,72.52,en,12,82\nplaying and if you ask me how I&#39;m,7.96,76.64,en,11,83\nfeeling don&#39;t tell me you&#39;re too my you,6.32,81.4,en,14,133\nsee Never Going To Give You Up never,6.199,84.6,en,8,78\ngoing to let you down never to run,6.679,87.72,en,8,72\naround and desert you never going to,7.28,90.799,en,7,58\nmake you cry never going to say goodbye,7.841,94.399,en,8,62\nnever going to tell a lie and hurt you,6.601,98.079,en,9,82\nnever going to give you up never going,5.44,102.24,en,8,89\nto let you down never going to run,6.64,104.68,en,8,73\naround and desert you never going to,7.52,107.68,en,7,56\nmake you cry never going to sing goodbye,7.52,111.32,en,8,64\ngoing to tell a lie and hurt,6.64,115.2,en,7,64\nyou,3,118.84,en,1,20\ngive,2.32,121.96,en,1,26\nyou give,6.639,125.24,en,2,19\nyou going to give going to give,8.2,127.64,en,7,52\nyou going to give going to give,8.161,131.879,en,7,52\nyou we&#39;ve known each other for so,7.52,135.84,en,10,80\nlong your heart&#39;s been aching but you&#39;re,6.88,140.04,en,13,114\ntoo sh to say inside we both know what&#39;s,5.12,143.36,en,12,141\nbeen going,5.8,146.92,en,2,21\non we the game and we&#39;re going to play,9.28,148.48,en,12,78\nit I just want to tell you how I&#39;m,8.92,152.72,en,12,81\nfeeling got to make you understand Never,6.72,157.76,en,7,63\nGoing To Give You Up never going to let,6.44,161.64,en,9,84\nyou down never going to run around and,7.479,164.48,en,8,65\ndesert you never going to make you cry,6.36,168.08,en,8,76\nnever going to say goodbye never going,6.681,171.959,en,7,63\nto tell you my and Hurt You Never Going,5.96,174.44,en,9,91\nTo Give You Up,4.239,178.64,en,4,57\nnever going to let you down never going,6.68,180.4,en,8,72\nto run around and desert you never going,8.161,182.879,en,8,59\nto make you C never going to say goodbye,5.32,187.08,en,9,102\nnever going to,5.6,191.04,en,3,33\ntell and Hur You Never Going To Give You,7.28,192.4,en,9,75\nUp never going to let you down never,7.319,196.64,en,8,66\ngoing to run around and desert you never,7.35,199.68,en,8,66\ngoing to make you going to,4.721,203.959,en,6,77\n[Music],3.97,207.03,en,1,16\ngoodbye,5.32,208.68,en,1,12\nand,3,211,en,1,20"