Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/YouTube/Vídeos do YouTube

Vídeos do YouTube

GET /v1/youtube/videos escopo read

Vídeos do canal (inclusive privados e agendados); channel escolhe a conta.

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

Parâmetros

Nome Onde Descrição
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.
max consulta Itens por página (até 50). Padrão: 20.
page consulta Token da próxima página (o next da resposta anterior).

Exemplo

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

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "videos": [
    {
      "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"
    }
  ],
  "next": null
}

next é o token da próxima página (mande em page); null na última. duration é a duração em ISO 8601 (PT58S).

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.