API para YouTube: Transcrição de vídeo (versão completa)
Obtenha a transcrição de um vídeo ou Short do YouTube com segmentos com tempo e sua procedência: se o texto vem de legendas escritas pelo criador ou de reconhecimento automático de fala.
US$ 2,00/mil req., pague por requisição, sem assinatura.
Transcript
{"text": "welcome back to the channel today we're going to talk about","startSeconds": 0,"endSeconds": 4.2}
Preços e provedores
Preços do endpoint Transcrição de vídeo (versão completa) da API para YouTube: uma API, 2 provedores intercambiáveis
O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.
Um provedor marcado como Fora de serviço parou de responder de forma confiável e foi retirado do rodízio, então suas chamadas vão para os outros. Ele volta sozinho assim que responder de forma confiável de novo.
Teste
Obtenha Transcrição de vídeo (versão completa) do YouTube em uma só requisição
Este exemplo mostra 24 de 25 campos. Ver todos os campos
{
"found": true,
"data": {
"transcript": "welcome back to the channel today we're going to talk about how sourdough starters actually work at a chemistry level first let's talk about the flour you use because that changes everything about fermentation speed",
"language": "en",
"isAutoGenerated": false,
"isAiGenerated": null,
"title": "The Science of Sourdough, Explained Simply",
"channel": "Kitchen Chemistry with Owen",
"durationSeconds": 612,
"segments": [
{
"text": "welcome back to the channel today we're going to talk about",
"startSeconds": 0,
"endSeconds": 4.2
},
{
"text": "how sourdough starters actually work at a chemistry level",
"startSeconds": 4.2,
"endSeconds": 9.1
},
{
"text": "first let's talk about the flour you use because that changes",
"startSeconds": 9.1,
"endSeconds": 14.6
},
{
"text": "everything about fermentation speed",
"startSeconds": 14.6,
"endSeconds": 17.8
}
],
"videoId": "nS3oOb6VwJq",
"url": "https://www.youtube.com/watch?v=nS3oOb6VwJq",
"description": "A deep dive into the microbiology and chemistry behind a healthy sourdough starter, with tips for troubleshooting a sluggish rise.",
"views": 341000,
"likes": 18900,
"authorId": "UC5sTr3u6vBzPq8fWdZgX9Lm",
"authorUrl": "https://www.youtube.com/@kitchenchemistrywithowen",
"image": "https://i.ytimg.com/vi/nS3oOb6VwJq/hqdefault.jpg",
"createdUtc": 1757462400,
"keywords": [
"sourdough",
"baking science",
"fermentation"
],
"category": "Education"
}
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- urlstring
https://www.youtube.com/watch?v=nS3oOb6VwJq
URL do vídeo ou Short do YouTube (ex.: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ou "https://www.youtube.com/shorts/Fir1x9cw2vg").
- captionKindenum
Qual faixa de legenda aceitar: "manual" só legendas escritas pelo criador, "automatic" só o reconhecimento de fala do YouTube, "any" a que existir.
- languagestring
Código do idioma preferido da legenda (ex.: "en", "es"). O padrão é inglês. Se o vídeo não tiver legendas nesse idioma, você recebe a transcrição em outro idioma disponível no vídeo; o campo `language` no resultado indica qual. Com `captionKind` definido como "manual" ou "automatic", nenhum outro idioma é retornado.
- requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `views`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma transcrição que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
JSON, um valor de exemplo por campo.
- authorIdstringpode ser exigido
UC5sTr3u6vBzPq8fWdZgX9Lm
YouTube channel ID of the publishing channel.
- authorUrlstringpode ser exigido
https://www.youtube.com/@kitchenchemistrywithowen
Canonical URL of the publishing channel, tracking query parameters stripped.
- categorystringpode ser exigido
Education
YouTube category the video is filed under, for example "Music".
- channelstring
Kitchen Chemistry with Owen
Channel name that published the video.
- createdUtcnumberpode ser exigido
1757462400
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- descriptionstringpode ser exigido
A deep dive into the microbiology and chemistry behind a healthy sourdough starter, with tips for troubleshooting a sluggish rise.
Full video description text.
- durationSecondsnumber
612
Video duration in seconds.
- imagestringpode ser exigido
https://i.ytimg.com/vi/nS3oOb6VwJq/hqdefault.jpg
URL of the video thumbnail image.
- isAiGeneratedboolean
null
True when the words were recognized from the audio by the serving lane rather than read from any YouTube caption track, or null when the serving source does not say.
- isAutoGeneratedboolean
false
True when YouTube generated the caption track by speech recognition rather than the creator supplying it. Automatic captions carry recognition errors, especially on names and jargon. Populated whenever the provider has data for the entity.
- keywordsstring[]pode ser exigido
Keywords the uploader tagged the video with.
- languagestring
en
Caption language code (e.g. "en"). Populated whenever the provider has data for the entity.
- likesintegerpode ser exigido
18900
Number of likes.
- titlestring
The Science of Sourdough, Explained Simply
Video title.
- transcriptstring
welcome back to the channel today we're going to talk about how sourdough starters actually work at a chemistry level first let's talk about the flour you use because that changes everything about fermentation speed
Full transcript text, segments joined in playback order. Populated whenever the provider has data for the entity.
- urlstring
https://www.youtube.com/watch?v=nS3oOb6VwJq
Watch URL of the video.
- videoIdstring
nS3oOb6VwJq
Unique identifier of the video.
- viewsintegerpode ser exigido
341000
Number of views.
Timed transcript segments in playback order. Populated whenever the provider has data for the entity.
- endSecondsnumber
4.2
Segment end offset in seconds.
- startSecondsnumber
0
Segment start offset in seconds.
- textstring
welcome back to the channel today we're going to talk about
Text of this transcript segment.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Dúvidas frequentes
Sobre o endpoint Transcrição de vídeo (versão completa) da API para YouTube
O endpoint Transcrição de vídeo (versão completa) da AnyAPI para YouTube retorna dados de YouTube em JSON normalizado com uma chamada POST para /v1/run/youtube.video_transcript_full. Obtenha a transcrição de um vídeo ou Short do YouTube com segmentos com tempo e sua procedência: se o texto vem de legendas escritas pelo criador ou de reconhecimento automático de fala. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 2 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Transcrição de vídeo (versão completa) da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 5,9 segundos, em 16.030 chamadas medidas.