API para YouTube

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.

POST/v1/run/youtube.video
Disponibilidade
99,92%
30d · 12.126 chamadas
Requisições
12.127
30d · semanal, últimas 12 sem.
Resposta
3,0s
mediana · 30d

Teste

Faça sua primeira requisição

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.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "found": true,
  "data": {
    "id": "dQw4w9WgXcQ",
    "title": "Official Video",
    "channel": "Rick Astley",
    "durationMs": 213000,
    "views": 1540000000,
    "likes": 17200000,
    "createdUtc": 1256453853,
    "description": "The official video."
  }
}
Interface da resposta
interface YoutubeVideoResponse {
  data: {
    authorAvatarUrl?: string;
    authorId?: string;
    authorUrl?: string;
    category?: string;
    channel: string;
    comments: number;
    createdUtc: number;
    description?: string;
    durationMs: number;
    id: string;
    image?: string;
    keywords?: string[];
    likes: number;
    title: string;
    views: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/youtube.video
curl -X POST https://api.getanyapi.com/v1/run/youtube.video \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
CampoTipoValor de exemplo
Corpo da requisição
idstringID do vídeo do YouTube. Um Short usa o mesmo tipo de ID que qualquer outro vídeo.
requireFieldsarrayOpcional; 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
foundbooleantrue
dataobject
data.idstring"dQw4w9WgXcQ"
data.titlestring"Official Video"
data.channelstring"Rick Astley"
data.durationMsnumber213000
data.viewsnumber1540000000
data.likesnumber17200000
data.createdUtcnumber1256453853
data.descriptionpode ser exigidostring"The official video."
Preço
Preço por requisiçãoUSDUS$ 0,0009
Preço /mil req.USDUS$ 0,90

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,90 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,9% das chamadas ao endpoint Vídeo da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,0 segundos, em 12.126 chamadas medidas.

Custa a partir de US$ 0,90 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

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 resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,9% das chamadas ao endpoint Vídeo da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,0 segundos, em 12.126 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.