429 Error from YouTube on First Transcript Request

Description:

I encountered a 429 Too Many Requests error when trying to extract the transcript of a YouTube video using markitdown. What’s strange is that this was my first request, and I haven’t been sending many requests at all.

Here’s the full error message:

Attempt 1 failed: 
Could not retrieve a transcript for the video https://www.youtube.com/watch?v=2S-WJN3L5eo! This is most likely caused by:

Request to YouTube failed: 429 Client Error: Too Many Requests for url: https://www.youtube.com/api/timedtext?v=2S-WJN3L5eo&ei=SWmFaMf_D8q4mLAP3pDDkAY&caps=asr&opi=112496729&exp=xpe&xoaf=4&xospf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1753598905&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=16612D6800A289A0684ECE99D81888B1FD831EE0.9FE82123F81315AA7EE61F0F345CCF79733D6838&key=yt8&kind=asr&lang=en&variant=punctuated

If you are sure that the described cause is not responsible for this error and that a transcript should be retrievable, please create an issue at https://github.com/jdepoix/youtube-transcript-api/issues. Please add which version of youtube_transcript_api you are using and provide the information needed to replicate the error. Also make sure that there are no open issues which already describe your problem!
Attempt 2 failed: 
Could not retrieve a transcript for the video https://www.youtube.com/watch?v=2S-WJN3L5eo! This is most likely caused by:

Request to YouTube failed: 429 Client Error: Too Many Requests for url: https://www.youtube.com/api/timedtext?v=2S-WJN3L5eo&ei=TGmFaIrMDKvevdIP19COqQE&caps=asr&opi=112496729&exp=xpe&xoaf=4&xospf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1753598908&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=E1E6AE37A6DBD3BFB74CDC03803CFABBA58DA6.1A72BB900977608BB94EBD697DF8F40D9E103D6C&key=yt8&kind=asr&lang=en&variant=punctuated

If you are sure that the described cause is not responsible for this error and that a transcript should be retrievable, please create an issue at https://github.com/jdepoix/youtube-transcript-api/issues. Please add which version of youtube_transcript_api you are using and provide the information needed to replicate the error. Also make sure that there are no open issues which already describe your problem!
Attempt 3 failed: 
Could not retrieve a transcript for the video https://www.youtube.com/watch?v=2S-WJN3L5eo! This is most likely caused by:

Request to YouTube failed: 429 Client Error: Too Many Requests for url: https://www.youtube.com/api/timedtext?v=2S-WJN3L5eo&ei=T2mFaO6AFNX2xN8P-dKz0AM&caps=asr&opi=112496729&exp=xpe&xoaf=4&xospf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1753598911&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=932B088B36DA952C6AC34EDDDED05F5F50827B7F.E2F4940C2A4B570D684481A506CE87D1D68BC710&key=yt8&kind=asr&lang=en&variant=punctuated

If you are sure that the described cause is not responsible for this error and that a transcript should be retrievable, please create an issue at https://github.com/jdepoix/youtube-transcript-api/issues. Please add which version of youtube_transcript_api you are using and provide the information needed to replicate the error. Also make sure that there are no open issues which already describe your problem!
Processing YouTube video content from https://www.youtube.com/watch?v=2S-WJN3L5eo&t=11s&ab_channel=Jubilee for kb_id: youtube
result : [حول](https://www.youtube.com/about/)[الصحافة](https://www.youtube.com/about/press/)[حقوق الطبع والنشر](https://www.youtube.com/about/copyright/)[التواصل معنا](/t/contact_us/)[صنّاع المحتوى](https://www.youtube.com/creators/)[الإعلان](https://www.youtube.com/ads/)[مطوّرو البرامج](https://developers.google.com/youtube)[الأحكام](/t/terms)[الخصوصية](/t/privacy)[السياسة والأمان](https://www.youtube.com/about/policies/)[آلية عمل YouTube](https://www.youtube.com/howyoutubeworks?utm_campaign=ytgen&utm_source=ythp&utm_medium=LeftNav&utm_content=txt&u=https%3A%2F%2Fwww.youtube.com%2Fhowyoutubeworks%3Futm_source%3Dythp%26utm_medium%3DLeftNav%26utm_campaign%3Dytgen)[تجربة الميزات الجديدة](/new)

© 2025 Google LLC

I saw that the error message is likely coming from youtube-transcript-api, and it’s suggesting I may have been rate-limited. But again, this was my first attempt, and I’m not behind a VPN.

is this a yt-transcript or markitdown issue?

Let me know if there's anything I can tweak or help test!

Start by reproducing the transcript request for the YouTube URL and inspect how markitdown invokes youtube-transcript-api. Determine whether the 429 response originates in markitdown or the dependency, then document the confirmed cause and a reproducible test or next step.