Bug Report: GET /v1/youtube/transcript returns 206 (Transcript Unavailable) when lang parameter is omitted, even when captions exist

Bug Report: GET /v1/youtube/transcript returns 206 (Transcript Unavailable) when lang parameter is omitted, even when captions exist Severity: High — causes false negatives for videos with non-English captions Description When calling GET /v1/youtube/transcript without the lang query parameter, the API returns HTTP 206 with {"error": "transcript-unavailable"} for videos that do have captions available (e.g., Portuguese auto-generated captions). However, when the same request includes any lang parameter (even a language that doesn't match the video's captions), the API correctly falls back to the first available language and returns HTTP 200 with the full transcript. Steps to Reproduce Video: mkn_Bx-qe4o (has Portuguese auto-generated captions, visible in the YouTube player) Request 1 — WITHOUT lang (fails): curl -s -w "\nHTTP: %{http_code}" "https://api.supadata.ai/v1/youtube/transcript?videoId=mkn_Bx-qe4o&text=true" -H "x-api-key: YOUR_KEY" Response: HTTP: 206 {"error":"transcript-unavailable","message":"Transcript Unavailable","details":"No transcript is available for this video","documentationUrl":"https://docs.supadata.ai/errors/transcript-unavailable"} Request 2 — WITH lang=pt (succeeds): curl -s -w "\nHTTP: %{http_code}" "https://api.supadata.ai/v1/youtube/transcript?videoId=mkn_Bx-qe4o&text=true&lang=pt" -H "x-api-key: YOUR_KEY" Response: HTTP: 200 {"lang":"pt","availableLangs":["pt"],"content":"[música] Boa noite, seja novamente muito bem-vindo ao dia 2 do nosso seminário..."} Request 3 — WITH lang=en (also succeeds — falls back to PT): curl -s -w "\nHTTP: %{http_code}" "https://api.supadata.ai/v1/youtube/transcript?videoId=mkn_Bx-qe4o&text=true&lang=en" -H "x-api-key: YOUR_KEY" Response: HTTP: 200 {"lang":"pt","availableLangs":["pt"],"content":"[música] Boa noite, seja novamente muito bem-vindo ao dia 2 do nosso seminário..."} Expected Behavior When lang is omitted, the API should behave the same as when lang is provided with a non-matching language: fall back to the first available transcript language and return HTTP 200 with the content. Per your own documentation: "If the video does not have a transcript in the preferred language, the endpoint will return a transcript in the first available language and a list of other available languages." This fallback should also apply when no lang preference is specified at all. Actual Behavior When lang is omitted, the API returns 206 with transcript-unavailable instead of falling back. This only happens when there is no "default" language transcript (likely English). Videos with only non-English captions (e.g., Portuguese, Spanish) are affected. Impact This bug causes all videos with only non-English captions to appear as having no transcripts available, even though captions are clearly present in the YouTube player. The workaround is to always include a lang parameter, which triggers the correct fallback behavior. Environment Plan: Free (but the behavior is API logic, not plan-related) Date tested: March 20, 2026 Endpoint: GET /v1/youtube/transcript

rodrigo.pinto About 3 hours ago

Team Management / Multi-user Support

I want to be able to add team members as users to my organization so that we can manage the account together. Currently, there is no way to invite users or assign roles.

info 2 days ago

Support for Age-Restricted YouTube Videos (Authentication/Cookies)

I want to be able to access age-restricted YouTube videos through the Supadata API. Currently, these videos return a 403 Forbidden error because they require authentication that isn't supported. It would be great to have a way to provide YouTube cookies or another form of authentication to bypass these restrictions.

adriantonyrobinson 2 days ago

1010 Error

Hi, i was running transcript fetching successfully in the past, but now i am getting a 1010 error code when trying to fetch new transcripts

jangryczan 3 days ago

Video Upscaling to 4K HD

I want to be able to convert or upscale my videos to 4K HD quality. This would be helpful for improving the visual quality of the content I'm working with.

shubhampradhanshubham3 5 days ago

Video Quality Enhancement / Upscaling

I want to be able to improve the quality of videos (upscaling) so that I can upload them to social media sites in high resolution. This is important for making content look professional on social platforms.

deathman701 7 days ago

Include views and like counts in batch response

I want the batch response to include views and like counts for videos. Currently, it only includes transcripts and basic metadata, which means I have to query individual videos to get engagement metrics. This would be much more efficient for processing large numbers of videos.

naz 8 days ago

YouTube Batch request does not return likes count or views count

why is it that ViewsCount and LikesCount is not returned in the batch request! in the video.batch it returned it but the data was wrong

naz 9 days ago

from today not working all of a sudden

usually get 500 successful transcript fetches everyday. today i have 20. meaning most of the calls hit error. loads forever on request. lots of credits left. the transcripts are available for the vids Supadata transcript fetch for KA0V94XXxto failed: Unexpected error response format. Transcript for KA0V94XXxto resulted in empty items, possibly disabled.

tmdwn12512 20 days ago

1

Download past invoices

I can no longer download invoices after I switched from paid to free. Is it possible to get emailed the invoice?

karsten 21 days ago

Support OCR for TikTok and Instagram Reels

Some posts that I’m trying to analyze use captions on the video instead of narration to communicate information. I’d love to be able to extract this as well.

micksmaccallum 22 days ago

Comments for YT video

Wouldn’t be cool to have a standalone endpoint to get comments which are below YT video? Have you thought about that? Would we see this in the nearest future?

igorryd7 26 days ago

Getting a 500 error when trying to fetch metadata with image.

{ "error": "internal-error", "message": "Internal Error", "details": "Failed to extract content", "documentationUrl": "https://docs.supadata.ai/errors/internal-error" }

levanton21 About 1 month ago

2

Can't get transcription list

For some reason, I'm not getting any transcriptLanguages back even for the videos that previously used to work correctly. When will it be fixed?

kolberszymon About 1 month ago

2

wrong transcript language returned from a specific video

fetching transcripts for https://www.youtube.com/watch?v=OTVE5iPMKLg returns arabic transcripts when english ones exist. my settings: const result = await supadata.transcript({ url: videoUrl, lang: "en", text: true, mode: "native", });

web About 1 month ago

2

Speaker annotation on transcripts

When a video has multiple speakers, the transcript should identify the speakers (speaker A, B, …) similar to Descript

Jake Go About 1 month ago

Incorrect / Mismatched Transcript Returned for YouTube Video

We are facing an issue with the YouTube transcript generation for a specific video ID using your transcription service. Issue Description: For the provided YouTube video ID, the transcript returned by your system appears to be incorrect and does not correspond to the actual video content. Observed Behavior: The YouTube video duration is approximately 2 hours. However, the transcript returned is only around 25 seconds long. The transcript content does not match any part of the original video. The returned transcript appears to be unrelated or possibly from a different video (fake/incorrect transcript).

Vipul Citrusbug About 1 month ago

6

YouTube Channel Metadata API returns truncated description

User is fetching metadata on a YouTube channel using the /v1/youtube/channel endpoint and the description field is returned truncated with "..." at the end. The user requires the full, untruncated channel description for their use case. The current behavior is undocumented and appears to be a limitation of the API. Example of truncated response provided: { "description": "Welcome to the official Difiaba YouTube channel — For hairstylists who demand performance-driven results, Difiaba is your trusted ally. We promise, and we de...", }

sergey About 1 month ago

YouTube Thumbnails from Supadata API Are Always Blurry

nyone else running into this? When I call Supadata's metadata endpoint for YouTube videos, the thumbnail URLs it returns are always the low-res default.webp version (very blurry/pixelated at anything above tiny size). Example: https://i.ytimg.com/vi_webp/PqVbypvxDto/default.webp

michaellu239 About 1 month ago

Mixed Language Transcript

The transcript is not right; it's not original from the audio. For example, I have this video; the audio is in Chinese, and there are no captions at all. As a result of the transcript, it's a mix of English and Chinese, with the majority of the language. this is not right I have attached the transcript generated from this video from supadata the mode is : mode=generate https://www.youtube.com/watch?v=9-3kUKUM9po

erikxiangzhou About 1 month ago