Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/YouTube/Ver vídeo do YouTube

Ver vídeo do YouTube

GET /v1/youtube/videos/:id escopo read

Um vídeo do canal.

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
id caminho Id do vídeo no YouTube.

Exemplo

curl "https://praeko.app/v1/youtube/videos/dQw4w9WgXcQ" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "video": {
    "id": "dQw4w9WgXcQ",
    "title": "O teste que só falhava na segunda",
    "description": "Um teste que passava de terça a domingo.",
    "publishedAt": "2026-11-01T12:00:00Z",
    "privacy": "public",
    "publishAt": null,
    "duration": "PT58S",
    "tags": [
      "programação",
      "testes"
    ],
    "viewCount": 1240,
    "likes": 87,
    "comments": 12,
    "url": "https://youtu.be/dQw4w9WgXcQ"
  }
}

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.