Skip to main content
POST
/
api
/
v1
/
get-youtube-transcript
Get YouTube transcript
curl --request POST \
  --url https://app.dumplingai.com/api/v1/get-youtube-transcript \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "<string>",
  "preferredLanguage": "<string>",
  "includeTimestamps": true,
  "timestampsToCombine": 2,
  "requestSource": "API"
}
'
{
  "language": "<string>",
  "transcript": "<string>"
}

​
Description

This endpoint extracts the transcript from a specified YouTube video URL, formats the transcript, and optionally includes timestamps.

​
Endpoint

POST https://app.dumplingai.com/api/v1/get-youtube-transcript

​
Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

​
Request Body

{
  "videoUrl": "string", // Required. The URL of the YouTube video.
  "includeTimestamps": "boolean", // Optional. Whether to include timestamps in the transcript. Default: true.
  "timestampsToCombine": "number", // Optional. The number of timestamps to combine in the transcript. Default: 5.
  "preferredLanguage": "string" // Optional. Preferred language for the transcript.
}

​
Accepted Values for preferredLanguage

The preferredLanguage parameter accepts the following language codes:
Language CodeLanguage
afAfrikaans
akAkan
sqAlbanian
amAmharic
arArabic
hyArmenian
asAssamese
ayAymara
azAzerbaijani
bnBangla
euBasque
beBelarusian
bhoBhojpuri
bsBosnian
bgBulgarian
myBurmese
caCatalan
cebCebuano
zhChinese
zh-HKChinese (Hong Kong)
zh-CNChinese (China)
zh-SGChinese (Singapore)
zh-TWChinese (Taiwan)
zh-HansChinese (Simplified)
zh-HantChinese (Traditional)
hak-TWHakka Chinese (Taiwan)
nan-TWMin Nan Chinese (Taiwan)
coCorsican
hrCroatian
csCzech
daDanish
dvDivehi
nlDutch
enEnglish
en-USEnglish (United States)
eoEsperanto
etEstonian
eeEwe
filFilipino
fiFinnish
frFrench
glGalician
lgGanda
kaGeorgian
deGerman
elGreek
gnGuarani
guGujarati
htHaitian Creole
haHausa
hawHawaiian
iwHebrew
hiHindi
hmnHmong
huHungarian
isIcelandic
igIgbo
idIndonesian
gaIrish
itItalian
jaJapanese
jvJavanese
knKannada
kkKazakh
kmKhmer
rwKinyarwanda
koKorean
kriKrio
kuKurdish
kyKyrgyz
loLao
laLatin
lvLatvian
lnLingala
ltLithuanian
lbLuxembourgish
mkMacedonian
mgMalagasy
msMalay
mlMalayalam
mtMaltese
miMāori
mrMarathi
mnMongolian
neNepali
nsoNorthern Sotho
noNorwegian
nyNyanja
orOdia
omOromo
psPashto
faPersian
plPolish
ptPortuguese
paPunjabi
quQuechua
roRomanian
ruRussian
smSamoan
saSanskrit
gdScottish Gaelic
srSerbian
snShona
sdSindhi
siSinhala
skSlovak
slSlovenian
soSomali
stSouthern Sotho
esSpanish
suSundanese
swSwahili
svSwedish
tgTajik
taTamil
ttTatar
teTelugu
thThai
tiTigrinya
tsTsonga
trTurkish
tkTurkmen
ukUkrainian
urUrdu
ugUyghur
uzUzbek
viVietnamese
cyWelsh
fyWestern Frisian
xhXhosa
yiYiddish
yoYoruba
zuZulu

​
Responses

​
Success (200)

Returns the transcript of the specified YouTube video and the language that was actually returned. 
{
  "transcript": "string",
  "language": "string"
}
  • Content-Type: application/json
  • X-RateLimit-Limit: The rate limit for the user.
  • X-RateLimit-Remaining: The remaining number of requests for the user.

​
Bad Request (400)

Returned if the request is invalid or missing required parameters. 
{
  "error": "Error message describing the issue"
}

​
Not Found (404)

Returned if no subtitles are found for the video. 
{
  "error": "No subtitles found for the video: <videoID>"
}

​
Internal Server Error (500)

Returned if there’s an error during the transcript extraction process. 
{
  "error": "Error message describing the issue"
}

​
Example Request

curl -X POST https://app.dumplingai.com/api/v1/get-youtube-transcript \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "videoUrl": "https://www.youtube.com/watch?v=example",
  "includeTimestamps": true,
  "timestampsToCombine": 5,
  "preferredLanguage": "en"
}'

​
Example Response

{
  "transcript": "00:00 - Welcome to this video.\n00:05 - Today we'll be discussing...",
  "language": "en"
}

​
Notes

  • The videoUrl parameter must be a valid YouTube video URL.
  • If includeTimestamps is set to false, the transcript will not include timestamp information.
  • The timestampsToCombine parameter determines how many individual transcript segments are combined into a single line with a timestamp.
  • The preferredLanguage parameter allows you to request a specific transcript language.
  • If the requested preferredLanguage is not available but the video has captions in another language, the endpoint will automatically fall back to the first available transcript instead of failing.
  • The language field in the response always reflects the transcript language that was actually returned, which may differ from preferredLanguage.
  • This endpoint uses 20 credits per request.
  • The transcript extraction attempts to retrieve the captions of a YouTube video. Some videos have captions disabled, this action will fail on these videos.

​
Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
videoUrl
string<uri>
required

Full YouTube video URL.

​
preferredLanguage
string

Preferred transcript language code. If unavailable, DumplingAI falls back to the first available transcript language for the video.

​
includeTimestamps
boolean

Include timestamps in the transcript output.

​
timestampsToCombine
integer

Number of consecutive transcript segments to merge.

Required range: x >= 1
​
requestSource
enum<string>

Optional identifier describing where the API request originated.

Available options:
API,
WEB,
MAKE_DOT_COM,
ZAPIER,
N8N,
PLAYGROUND,
DEFAULT_AUTOMATION,
AGENT_PREVIEW,
AGENT_LIVE,
AUTOPILOT,
STUDIO

Response

Transcript retrieved.

​
language
string

Transcript language returned by the API. This may differ from preferredLanguage when DumplingAI falls back to the first available transcript.

​
transcript
string

Transcript formatted as newline separated segments.