API para YouTube

API para YouTube: Buscar

Busque no YouTube e receba os vídeos correspondentes: título, canal, visualizações, duração e data de publicação.

US$ 0,50/mil req., pague por requisição, sem assinatura.

apollo 11 landing - YouTube
youtube.com/results?search_query=apollo%2011%20landing
YouTube
Sign in
AllShortsUnwatchedVideosRecently uploadedLive
4:14

Apollo 11 Moon Landing: Restored Footage

14.9M views · 2 years ago

NASA

O que a API retornouvideos[0]
{
"id": "BzSzwqb-OEE",
"url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
"title": "Apollo 11 Moon Landing: Restored Footage",
"channel": "NASA",
"views": 14860541,
"lengthText": "4:14",
"publishedTime": "2 years ago",
"authorAvatarUrl": string,
... 3 campos a mais
}
Disponibilidade
100,00%
30d · 110.522 chamadas
Requisições
110.556
30d · semanal, últimas 12 sem.
Resposta
2,0s
mediana · 30d

Preços e provedores

Preços do endpoint Buscar 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.

Você paga
US$ 5,00
US$ 0,50/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 200 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Buscar do YouTube em uma só 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 `nextCursor`, 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 resultado 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. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
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.

Este exemplo mostra 10 de 16 campos. Ver todos os campos

{
  "found": true,
  "data": {
    "videos": [
      {
        "id": "BzSzwqb-OEE",
        "url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
        "title": "Apollo 11 Moon Landing: Restored Footage",
        "channel": "NASA",
        "views": 14860541,
        "lengthText": "4:14",
        "publishedTime": "2 years ago"
      }
    ]
  }
}

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.

  • querystring

    apollo 11 landing

    O termo de busca no YouTube.

  • cursorstring

    Token de continuação de uma resposta anterior, para paginação.

  • requireCursorboolean

    Obsoleto; envie `requireFields: ["nextCursor"]` no lugar, que faz exatamente a mesma coisa. Defina como true se pretende paginar os resultados, para que a requisição seja atendida só por uma fonte que retorne um nextCursor. Se omitido, o roteamento não muda e a fonte mais barata atende. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue paginar, uma fonte que consegue atende, e a cotação e a cobrança seguem o preço dela. Ele continua aceito para que quem já o envia siga funcionando.

  • 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 `nextCursor`, 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 resultado 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. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.

  • sortByenum

    Ordem: "relevance" (padrão) ou "popular" (mais vistos).

  • uploadDateenum

    Filtra pela data de envio. Omita para qualquer data.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

datadata
  • nextCursorstringpode ser exigido

    Opaque cursor for the next page of results, or null when this lane has no more. Pass it back as cursor to continue.

each videodata.videos[]

Populated whenever the provider has data for the entity.

  • authorAvatarUrlstring

    URL of the publishing channel's avatar image.

  • authorIdstring

    YouTube channel ID of the publishing channel.

  • channelstring

    NASA

    Populated whenever the provider has data for the entity.

  • createdUtcnumber

    UTC epoch timestamp in seconds (Unix time), estimated from the relative age YouTube shows such as "4 days ago", so it can be off by up to that label's unit (a day, a week, a month). Multiply by 1000 for a JS Date in milliseconds.

  • idstring

    BzSzwqb-OEE

    Populated whenever the provider has data for the entity.

  • imagestring

    URL of the video thumbnail image, tracking query parameters stripped.

  • lengthTextstring

    4:14

  • publishedTimestring

    2 years ago

    Populated whenever the provider has data for the entity.

  • titlestring

    Apollo 11 Moon Landing: Restored Footage

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.youtube.com/watch?v=BzSzwqb-OEE

    Populated whenever the provider has data for the entity.

  • viewsinteger

    14860541

top level
  • 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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Vende esta API? Veja o schema completo que o seu endpoint precisa retornar.

Dúvidas frequentes

Sobre o endpoint Buscar da API para YouTube

O endpoint Buscar da AnyAPI para YouTube retorna dados de YouTube em JSON normalizado com uma chamada POST para /v1/run/youtube.search. Busque no YouTube e receba os vídeos correspondentes: título, canal, visualizações, duração 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,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,0 segundos, em 110.522 chamadas medidas.

Custa a partir de US$ 0,50 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.

Busque no YouTube e receba os vídeos correspondentes: título, canal, visualizações, duração 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, 100,0% das chamadas ao endpoint Buscar da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,0 segundos, em 110.522 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.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 200 chamadas de Buscar do YouTube a US$ 0,0005 cada.

A AnyAPI consulta a próxima das suas 3 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/youtube.search com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.