API para YouTube: Vídeo
Metadados completos de um vídeo ou Short por URL ou ID: título, descrição, canal, número de visualizações e curtidas e data de publicação.
US$ 0,80/mil req., pague por requisição, sem assinatura.
Official Video
Rick Astley
1.5B views · Oct 25, 2009
The official video.
{"id": "dQw4w9WgXcQ","title": "Official Video","channel": "Rick Astley","durationMs": 213000,"views": 1540000000,"likes": 17200000,"createdUtc": 1256453853,"description": "The official video.",... 7 campos a mais}
Preços e provedores
Preços do endpoint Vídeo da API para YouTube: uma API, 3 provedores intercambiáveis
O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.
Teste
Obtenha Vídeo do YouTube em uma só requisição
Este exemplo mostra 10 de 18 campos. Ver todos os campos
{
"found": true,
"data": {
"id": "dQw4w9WgXcQ",
"title": "Official Video",
"channel": "Rick Astley",
"durationMs": 213000,
"views": 1540000000,
"likes": 17200000,
"createdUtc": 1256453853,
"description": "The official video."
}
}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.
- idstring
ID do vídeo do YouTube. Um Short usa o mesmo tipo de ID que qualquer outro vídeo.
- 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 `authorAvatarUrl`, 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 um vídeo 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. Uma fonte que retorna só um valor arredondado ou abreviado de um campo não conta como fonte que retorna esse campo.
- urlstring
https://www.youtube.com/watch?v=dQw4w9WgXcQ
URL completa do vídeo do YouTube. URLs de Shorts (youtube.com/shorts/...), youtu.be, de lives e de embed funcionam.
Resposta
JSON, um valor de exemplo por campo.
The video result, or null when not found.
- authorAvatarUrlstringpode ser exigido
URL of the publishing channel's avatar image.
- authorIdstring
YouTube channel ID of the publishing channel.
- authorUrlstring
Canonical URL of the publishing channel, tracking query parameters stripped.
- categorystring
YouTube category the video is filed under, for example "Music".
- channelstring
Rick Astley
Name of the channel that published the video. Populated whenever the provider has data for the entity.
- commentsintegerpode ser exigido
Number of comments. Some sources round large counts (2.4M instead of 2,457,538); name `comments` in requireFields to be served only by a source that returns the exact count.
- createdUtcnumber
1256453853
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- descriptionstringpode ser exigido
The official video.
Video description text. Some sources return it as YouTube displays it, with long links shortened (https://colab.research.google.com/dri...) and YouTube or social links replaced by their titles; name `description` in requireFields to be served only by a source that returns every link intact.
- durationMsinteger
213000
Duration of the video in milliseconds.
- idstring
dQw4w9WgXcQ
Unique identifier of the video. Populated whenever the provider has data for the entity.
- imagestring
URL of the video thumbnail image.
- keywordsstring[]
Keywords the uploader tagged the video with.
- likesinteger
17200000
Number of likes.
- titlestring
Official Video
Title of the video. Populated whenever the provider has data for the entity.
- viewsinteger
1540000000
Number of views.
- foundboolean
true
Whether the video was found.
- 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.
Vende esta API? Veja o schema completo que o seu endpoint precisa retornar.
Dúvidas frequentes
Sobre o endpoint Vídeo da API para YouTube
O endpoint Vídeo da AnyAPI para YouTube retorna dados de YouTube em JSON normalizado com uma chamada POST para /v1/run/youtube.video. Metadados completos de um vídeo ou Short por URL ou ID: título, descrição, canal, número de visualizações e curtidas e data de publicação. A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,80 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,8% das chamadas ao endpoint Vídeo da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,1 segundos, em 56.887 chamadas medidas.