Get Transcript Translation
This API fetches a transcript/subtitles from a YouTube video and translates it to the specified language.
Quick Start
Request
curl -X GET 'https://api.supadata.ai/v1/youtube/transcript/translation?videoId=dQw4w9WgXcQ&lang=es&text=true' \
-H 'x-api-key: YOUR_API_KEY'
Response
{
"content": "Nunca voy a abandonarte, nunca voy a decepcionarte…",
"lang": "es"
}
This endpoint has longer than usual response times. See Latency for more details.
Specification
Endpoint
GET https://api.supadata.ai/v1/youtube/transcript/translation
Each request requires an x-api-key
header with your API key available after signing up. Find out more about Authentication.
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
url | string | Yes* | YouTube video URL. See Supported YouTube URL Formats. |
videoId | string | Yes* | YouTube video ID. Alternative to URL. |
lang | string | Yes | ISO 639-1 language code of the translation |
text | boolean | No | When true, returns plain text transcript. Default: false |
chunkSize | number | No | Maximum characters per transcript chunk (only when text=false) |
* Either url
or videoId
must be provided
Response Format
When text=true
:
{
"content": string,
"lang": string // ISO 639-1 language code
}
When text=false
:
{
"content": [
{
"text": string, // Transcript segment
"offset": number, // Start time in milliseconds
"duration": number, // Duration in milliseconds
"lang": string // ISO 639-1 language code of chunk
}
],
"lang": string // ISO 639-1 language code of transcript
}
Latency
Due to the duration of transcript translation tasks, the endpoint may take 20 or more seconds to complete. Please make sure to increase the request timeout in your application.
Error Codes
The API returns HTTP status codes and error codes. See this page for more details.
Supported YouTube URL Formats
url
parameter supports various YouTube URL formats. See this page for more details.
Pricing
- 1 minute of transcript = 30 credits