YouTube (dados públicos)

YouTube (dados públicos): Busca, vídeos, canais, comentários e transcrições públicas.

Atualizado em .

O que é YouTube (dados públicos) na APIcultura

Acesse YouTube (dados públicos) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Busca, vídeos, canais, comentários e transcrições públicas. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Redes (dados públicos). Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)O que fazPreço por chamadaRota
youtube-buscar-videosBuscar vídeosR$ 0,01POST /v1/call/youtube-buscar-videos
youtube-videoDetalhe de um vídeoR$ 0,01POST /v1/call/youtube-video
youtube-comentariosComentários de um vídeoR$ 0,01POST /v1/call/youtube-comentarios
youtube-legendasLegendas de um vídeoR$ 0,02POST /v1/call/youtube-legendas
youtube-canalDados de um canalR$ 0,01POST /v1/call/youtube-canal
youtube-videos-canalVídeos de um canalR$ 0,01POST /v1/call/youtube-videos-canal
youtube-shorts-em-altaShorts em altaR$ 0,02POST /v1/call/youtube-shorts-em-alta
youtube-patrocinadores-videoPatrocinadores de um vídeoR$ 0,02POST /v1/call/youtube-patrocinadores-video

Buscar vídeos (youtube-buscar-videos)

Resultados de busca do YouTube. Preço: R$ 0,01 por chamada.

Schema de entrada de youtube-buscar-videos

{
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Detalhe de um vídeo (youtube-video)

Dados e métricas de um vídeo. Preço: R$ 0,01 por chamada.

Schema de entrada de youtube-video

{
  "required": [
    "video"
  ],
  "properties": {
    "video": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Comentários de um vídeo (youtube-comentarios)

Comentários de um vídeo público. Preço: R$ 0,01 por chamada.

Schema de entrada de youtube-comentarios

{
  "required": [
    "video"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "video": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Legendas de um vídeo (youtube-legendas)

Legendas e transcrição de um vídeo. Preço: R$ 0,02 por chamada.

Schema de entrada de youtube-legendas

{
  "required": [
    "video"
  ],
  "properties": {
    "language": {
      "type": "string",
      "maxLength": 2000
    },
    "video": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Dados de um canal (youtube-canal)

Inscritos e dados públicos de um canal. Preço: R$ 0,01 por chamada.

Schema de entrada de youtube-canal

{
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Vídeos de um canal (youtube-videos-canal)

Vídeos mais recentes de um canal. Preço: R$ 0,01 por chamada.

Schema de entrada de youtube-videos-canal

{
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    }
  }
}

Mais 2 endpoints na tabela acima; os parâmetros seguem o input_schema de cada um.

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "youtube-buscar-videos", "input": {"query":"rust programming"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/youtube-buscar-videos \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"rust programming"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Experimente

Teste no playground interativo: YouTube (dados públicos) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. YouTube (dados públicos) é marca de seus respectivos donos, citada apenas para identificar a integração.