Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Canais/Registrar seguidores

Registrar seguidores

PUT /v1/channels/:network/followers escopo write

Informa a contagem de seguidores à mão (só Instagram; channel escolhe a conta). Vira o registro do dia.

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

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

Parâmetros

Nome Onde Descrição
network caminho Rede: youtube, instagram ou tiktok.
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.

Corpo da requisição

JSON. Campos obrigatórios precisam ir; os outros podem ser omitidos. Só vale para instagram (no TikTok e no YouTube os seguidores já vêm da API; a rede errada dá 409 followers_from_api).

Campo Tipo Descrição
value obrigatório inteiro Quantidade de seguidores. De 0 a 1000000000.
day (opcional) texto Dia do registro, AAAA-MM-DD, no máximo amanhã. Sem ele, hoje no fuso do canal.
Exemplo de corpo
{
  "value": 1842,
  "day": "2026-11-06"
}

Exemplo

curl -X PUT "https://praeko.app/v1/channels/youtube/followers" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en" \
  -H "Content-Type: application/json" \
  -d '{
  "value": 1842,
  "day": "2026-11-06"
}'

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "network": "instagram",
  "day": "2026-11-06",
  "followers": 1842,
  "source": "manual"
}

Erros

Status code Quando
400 empty_body O corpo veio vazio.
400 invalid_json O corpo não é um objeto JSON.
413 body_too_large O corpo passa de 1 MB.
409 followers_from_api A rede já traz os seguidores pela API (só instagram aceita valor manual).
422 invalid_field value ou day inválidos.
404 channel_not_found Canal não conectado.

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.