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.

POST/v1/run/youtube.search
Disponibilidade
100,00%
30d · 15.769 chamadas
Requisições
15.769
30d · semanal, últimas 12 sem.
Resposta
2,3s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

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 `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.
{
  "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"
      }
    ]
  }
}
Interface da resposta
interface YoutubeSearchResponse {
  data: {
    nextCursor?: string | null;
    videos: {
      authorAvatarUrl?: string;
      authorId?: string;
      channel: string;
      createdUtc?: number;
      id: string;
      image?: string;
      lengthText: string;
      publishedTime: string;
      title: string;
      url: 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.search
curl -X POST https://api.getanyapi.com/v1/run/youtube.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"apollo 11 landing"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"apollo 11 landing"O termo de busca no YouTube.
cursorstringToken de continuação de uma resposta anterior, para paginação.
requireCursorbooleanObsoleto; 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.
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 `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.
sortByenumOrdem: "relevance" (padrão) ou "popular" (mais vistos).
uploadDateenumFiltra pela data de envio. Omita para qualquer data.
Resposta
foundbooleantrue
dataobject
data.videosarray
data.videos[].idstring"BzSzwqb-OEE"
data.videos[].urlstring"https://www.youtube.com/watch?v=BzSzwqb-OEE"
data.videos[].titlestring"Apollo 11 Moon Landing: Restored Footage"
data.videos[].channelstring"NASA"
data.videos[].viewsnumber14860541
data.videos[].lengthTextstring"4:14"
data.videos[].publishedTimestring"2 years ago"
Preço
Preço por requisiçãoUSDUS$ 0,0005
Preço /mil req.USDUS$ 0,50

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,3 segundos, em 15.769 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,3 segundos, em 15.769 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.
Mais para chamar

Outros endpoints de YouTube

Canala partir de US$ 0,50 /mil req.Vídeoa partir de US$ 0,90 /mil req.Transcrição de vídeoa partir de US$ 0,90 /mil req.Vídeos do canala partir de US$ 0,50 /mil req.Comentários do vídeoa partir de US$ 1,20 /mil req.Posts da comunidade do canala partir de US$ 1,20 /mil req.Contato do canala partir de US$ 71,80 /mil req.Lives do canala partir de US$ 1,20 /mil req.Playlists do canala partir de US$ 1,20 /mil req.Shorts do canala partir de US$ 1,20 /mil req.Respostas a comentáriosa partir de US$ 1,20 /mil req.Post da comunidadea partir de US$ 1,20 /mil req.Playlista partir de US$ 1,20 /mil req.Buscar hashtaga partir de US$ 1,20 /mil req.Buscar Shortsa partir de US$ 1,20 /mil req.Shorts em altaa partir de US$ 1,20 /mil req.Patrocinadores do vídeoa partir de US$ 1,20 /mil req.Transcrição de vídeo (versão completa)a partir de US$ 1,00 /mil req.