API de dados do YouTube | Documentação de APIs

# YouTube Data API

Query YouTube videos, channels, Shorts, comments, community posts, search results and stream metadata through 34 authenticated endpoints: 32 GET and 2 POST.

## Authentication

Use your API Hop API key in the authorization header. Availability depends on enabled gateways and API key permissions; documentation alone does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests and caption tasks

GET operations use query parameters without a request body. Stream V3 uses POST with an application/json body and no query parameters; send proxy_url only in that body. The version segment selects the YouTube interface version. Unknown or duplicate fields are rejected. Keep identifiers and pagination cursors as strings, including values larger than JavaScript can safely represent as numbers.

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"
```

## Responses

Synchronous endpoints preserve the native JSON response. Caption endpoints return success, data.id, data.status, data.result and requestId. The examples below are illustrative, not live results.

```json
{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}
```

## Billing and pagination

For synchronous requests: Prices are per successful request, not per returned item. Every page is a separate request. Most operations cost $0.001. The two V2 search variants cost $0.002; the V2 stream variant costs $0.004. See each endpoint below. Account-specific prices take precedence. Supplier volume discounts are not automatically passed through. Failed upstream calls release the reservation; settlement failures return an error and do not trigger a second upstream request.

## Caption tasks

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions returns HTTP 202 and a platform task ID, with Location: /v1/jobs/\{id\}. Query GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} every 2–5 seconds. Only the owning tenant can read the task. Result queries are free; creation costs $0.008 at the list price. No-caption results are successful and billable. The format is fixed at creation (default srt); an optional result format must match or returns HTTP 400. data.result is null until COMPLETED; tasks may end as FAILED. These endpoints retrieve existing captions, not AI transcriptions.

If submission acceptance is uncertain, the request is not replayed and its reservation may remain held until the 30-minute task deadline. A supplier result may remain pending while settlement is reconciled. A transient polling error is not a terminal task failure.

```json
{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}
```

## Scope and limitations

The web and web-v2 paths select the upstream interface family. Stream V3 supports POST retrieval with your own fixed-exit HTTP proxy. Stream endpoints return metadata and URLs, not media files or guaranteed downloads. Channel descriptions may require a second separately billed request using continuation_token. No automatic retries are made.

Stream V3 uses POST JSON over HTTPS and costs $0.003 per successful request. Provide video_id and proxy_url (http:// with an explicit port and public host); private, loopback and link-local destinations are forbidden. URL-encode reserved characters in credentials. Use a fixed exit or sticky proxy session. itags defaults to ["137", "140"]; unavailable formats fail without substitution. verify_download defaults to false. Download through the same proxy session and actual public exit IP with streams[].download_headers. Successful URL extraction (HTTP 200) is billable even when all_selected_streams_verified or streams[].verified is false. Verification samples small byte ranges, not the complete file. URLs and proxy sessions expire independently; merge separate audio/video streams yourself.

## Reference

Select an endpoint and send only its documented fields. When alternatives are listed, provide at least one field from each group. Pagination values must come from the preceding response; there is no automatic pagination.

[Complete reference](https://apihop.ai/en/docs/api-reference/youtube/reference)

## Errors

Platform errors use HTTP 400 for invalid parameters, 401 for invalid authentication, 402 for insufficient credit, 403 for denied gateway access, 429 for rate limits, and 5xx for service or supplier failures. Keep X-Request-Id for troubleshooting. Do not treat an upstream HTTP 200 with a failed business code as success.

## Sources

The endpoint list and prices were checked against the official schema and live price metadata on 2026-10-31. Live metadata takes precedence over conflicting prose prices.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

Consulte vídeos, canais, Shorts, comentários, publicações da comunidade, buscas e metadados de mídia do YouTube por 34 endpoints autenticados: 32 GET e 2 POST.

Autenticação

Use sua chave API API Hop no cabeçalho de autorização. A disponibilidade depende dos gateways habilitados e das permissões da chave; a documentação não confirma disponibilidade em produção.

http

Authorization: Bearer YOUR_API_KEY

Pedidos e tarefas de legendas

As operações GET usam parâmetros de consulta sem corpo. A mídia V3 usa POST com corpo application/json e sem parâmetros de consulta; envie proxy_url somente no corpo. O segmento de versão seleciona a interface YouTube. Campos desconhecidos ou repetidos são rejeitados. Mantenha identificadores e cursores como strings, inclusive além do intervalo inteiro seguro do JavaScript.

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"

Respostas

Os endpoints síncronos preservam a resposta JSON original. Os de legendas devolvem success, data.id, data.status, data.result e requestId. Os exemplos são ilustrativos, não resultados reais.

json

{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}

Cobrança e paginação

Para requisições síncronas: A cobrança é por requisição bem-sucedida, não por item retornado. Cada página é uma requisição separada. A maioria das operações custa $0.001. As duas variantes de busca V2 custam $0.002 e a variante de mídia V2 custa $0.004. Consulte o preço de cada endpoint. Preços específicos da conta têm prioridade. Descontos por volume do fornecedor não são repassados automaticamente. Falhas do fornecedor liberam a reserva; falhas na liquidação retornam erro sem repetir a chamada ao fornecedor.

Tarefas de legendas

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions devolve HTTP 202, um ID de tarefa da plataforma e Location: /v1/jobs/\{id\}. Consulte GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} a cada 2–5 segundos. Apenas o tenant proprietário pode aceder. A consulta é gratuita; a criação custa $0.008 ao preço de tabela. Um resultado sem legendas é bem-sucedido e cobrado. O formato é fixado na criação (srt por omissão); o format opcional na consulta deve coincidir, caso contrário recebe HTTP 400. data.result é null até COMPLETED; também pode terminar em FAILED. São obtidas legendas existentes, sem transcrição por IA.

Se a aceitação for incerta, o pedido não é repetido e a reserva pode permanecer até ao prazo de 30 minutos da tarefa. O resultado pode ficar pendente durante a conciliação da faturação. Um erro temporário de consulta não significa falha definitiva da tarefa.

json

{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}

Escopo e limites

web e web-v2 selecionam a família de interfaces. A mídia V3 aceita POST com seu próprio proxy HTTP de saída fixa. Os endpoints de mídia retornam metadados e URLs, não arquivos nem garantia de download. A descrição de um canal pode exigir outra requisição cobrada com continuation_token. Não há novas tentativas automáticas.

A mídia V3 usa POST JSON por HTTPS e custa $0.003 por requisição bem-sucedida. Forneça video_id e proxy_url (http:// com porta explícita e host público). Destinos privados, de loopback e link local são proibidos; codifique os caracteres reservados das credenciais. Use saída fixa ou sessão persistente. itags tem padrão ["137", "140"]; formatos ausentes falham sem substituição. verify_download tem padrão false. Baixe com a mesma sessão de proxy, o mesmo IP público de saída real e streams[].download_headers. A extração bem-sucedida de URLs (HTTP 200) é cobrada mesmo quando all_selected_streams_verified ou streams[].verified é false. A verificação lê pequenas amostras de bytes, não o arquivo inteiro. URLs e sessões expiram separadamente; una os fluxos de áudio e vídeo no cliente.

Referência

Envie apenas os campos documentados do endpoint escolhido. Forneça ao menos um campo de cada grupo de alternativas. Os cursores vêm da resposta anterior; não há paginação automática.

Referência completa

Erros

HTTP 400 indica parâmetros inválidos, 401 autenticação inválida, 402 saldo insuficiente, 403 acesso negado, 429 limite de frequência e 5xx falhas do serviço ou fornecedor. Guarde X-Request-Id para diagnóstico. HTTP 200 com código de negócio de falha não é sucesso.

Fontes

Endpoints e preços foram conferidos em 2026-10-31 com o esquema oficial e metadados de preços atuais. Os metadados atuais prevalecem sobre preços conflitantes no texto.

TikHub · OpenAPI · Prices