Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Comentários/Comentários de todas as redes

Comentários de todas as redes

GET /v1/comments escopo read

Comentários de todas as redes juntos, de TODAS as contas ativas de cada rede (cada comentário traz channel; channel filtra uma conta; uma conta que falha vai para errors e as outras respondem).

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

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/comentarios.

Parâmetros

Nome Onde Descrição
network consulta Limita a uma rede (all junta todas). Valores: all, youtube, instagram.
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.

Exemplo

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

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "comments": [
    {
      "id": "17900123456789012",
      "network": "instagram",
      "mediaId": "17858893269123456",
      "author": "tristao.dev",
      "text": "Zika demais, qual banco você usa?",
      "publishedAt": "2026-11-04T16:46:50+0000",
      "likes": 1,
      "fromOwner": false,
      "hidden": false,
      "replyCount": 1,
      "answered": true,
      "replies": [
        {
          "id": "17900123456789999",
          "network": "instagram",
          "mediaId": "17858893269123456",
          "author": "dev.ocioso",
          "text": "Valeu! É o D1 da Cloudflare.",
          "publishedAt": "2026-11-04T19:00:00+0000",
          "likes": 0,
          "fromOwner": true,
          "hidden": false
        }
      ],
      "media": {
        "id": "17858893269123456",
        "title": "Reel de segunda: o teste que falhava",
        "thumbnail": "https://cdn.exemplo.com/reel.jpg",
        "type": "reel",
        "permalink": "https://www.instagram.com/reel/DAbCdEfGhIj/",
        "publishedAt": "2026-11-04T10:57:00+0000"
      },
      "resolved": false
    },
    {
      "id": "UgzK3n8vYb2Qx4mH7dB4AaABAg",
      "videoId": "dQw4w9WgXcQ",
      "author": "Ana",
      "authorChannel": "UCxk3n8vYb2Qx4mH7dB4Aana",
      "text": "O teste que só falhava na segunda me lembrou do meu último deploy.",
      "publishedAt": "2026-11-06T09:12:40Z",
      "likes": 3,
      "fromOwner": false,
      "replyCount": 0,
      "answered": false,
      "replies": [],
      "resolved": false,
      "network": "youtube",
      "channel": "01KA3V0R5D8M2WQ7X4HT9NZ1BF"
    }
  ],
  "mediaItems": [
    {
      "id": "17858893269123456",
      "network": "instagram",
      "title": "Reel de segunda: o teste que falhava",
      "caption": "Reel de segunda: o teste que falhava",
      "type": "reel",
      "thumbnail": "https://cdn.exemplo.com/reel.jpg",
      "permalink": "https://www.instagram.com/reel/DAbCdEfGhIj/",
      "publishedAt": "2026-11-04T10:57:00+0000",
      "likes": 34,
      "comments": 2,
      "pending": 0,
      "channel": "01KA3V1G4C7N9PXS2WQ6HM8TDZ"
    }
  ],
  "pending": 1,
  "pendingByNetwork": {
    "youtube": 1,
    "instagram": 0
  },
  "pendingByChannel": {
    "01KA3V0R5D8M2WQ7X4HT9NZ1BF": 1,
    "01KA3V1G4C7N9PXS2WQ6HM8TDZ": 0
  },
  "errors": {}
}

Reúne os comentários de todas as contas de cada rede. errors diz, por rede, qual conta não respondeu (as outras vêm normalmente).

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.