# YouTube (dados públicos)

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

URL: https://apicultura.app/ferramentas/youtube-publico/
Atualizado em 05/11/2026 (2026-11-05).

## 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)](/catalogo/?cat=social). 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 faz | Preço por chamada | Rota |
|---|---|---|---|
| `youtube-buscar-videos` | Buscar vídeos | R$ 0,01 | `POST /v1/call/youtube-buscar-videos` |
| `youtube-video` | Detalhe de um vídeo | R$ 0,01 | `POST /v1/call/youtube-video` |
| `youtube-comentarios` | Comentários de um vídeo | R$ 0,01 | `POST /v1/call/youtube-comentarios` |
| `youtube-legendas` | Legendas de um vídeo | R$ 0,02 | `POST /v1/call/youtube-legendas` |
| `youtube-canal` | Dados de um canal | R$ 0,01 | `POST /v1/call/youtube-canal` |
| `youtube-videos-canal` | Vídeos de um canal | R$ 0,01 | `POST /v1/call/youtube-videos-canal` |
| `youtube-shorts-em-alta` | Shorts em alta | R$ 0,02 | `POST /v1/call/youtube-shorts-em-alta` |
| `youtube-patrocinadores-video` | Patrocinadores de um vídeo | R$ 0,02 | `POST /v1/call/youtube-patrocinadores-video` |

### Buscar vídeos (`youtube-buscar-videos`)

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

- `limit` (integer, opcional)
- `query` (string, obrigatório), ex.: `rust programming`

### Schema de entrada de youtube-buscar-videos

```json
{
  "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.

- `video` (string, obrigatório), ex.: `dQw4w9WgXcQ`

### Schema de entrada de youtube-video

```json
{
  "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.

- `limit` (integer, opcional)
- `video` (string, obrigatório), ex.: `dQw4w9WgXcQ`

### Schema de entrada de youtube-comentarios

```json
{
  "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.

- `language` (string, opcional), ex.: `en`
- `video` (string, obrigatório), ex.: `dQw4w9WgXcQ`

### Schema de entrada de youtube-legendas

```json
{
  "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.

- `channel` (string, obrigatório), ex.: `@veritasium`

### Schema de entrada de youtube-canal

```json
{
  "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.

- `channel` (string, obrigatório), ex.: `UCHnyfMqiRRG1u-2MsSQLbXA`
- `limit` (integer, opcional)

### Schema de entrada de youtube-videos-canal

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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](/ferramentas/ferramenta.html?slug=youtube-publico). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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