Skip to content
Sign in Waitlist
Docs/API reference/Channels/Record followers

Record followers

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

Records the follower count by hand (Instagram only; channel picks the account). It becomes the record for that day.

HeadersAuthorization: Bearer praeko_… and X-Praeko-Contract: en. Always send both.

Legacy Portuguese alias (still answered, marked as deprecated): /v1/canais/:rede/seguidores.

Parameters

Name In Description
network path Network: youtube, instagram or tiktok.
channel query Account id when the network has several (from GET /v1/channels). Without it, the default channel.

Request body

JSON. Required fields must be sent; the others can be left out. Only valid for instagram (on TikTok and YouTube followers already come from the API; the wrong network returns 409 followers_from_api).

Field Type Description
value required integer Number of followers. 0 to 1000000000.
day (optional) string Day of the record, YYYY-MM-DD, at most tomorrow. Without it, today in the channel's time zone.
Body example
{
  "value": 1842,
  "day": "2026-11-06"
}

Example

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"
}'

Response

Success status When
200 Success.
Response 200
{
  "network": "instagram",
  "day": "2026-11-06",
  "followers": 1842,
  "source": "manual"
}

Errors

Status code When
400 empty_body The request body is empty.
400 invalid_json The request body is not a JSON object.
413 body_too_large The request body is larger than 1 MB.
409 followers_from_api The network already provides followers through its API (only instagram accepts a manual value).
422 invalid_field Invalid value or day.
404 channel_not_found Channel not connected.

Errors on any route

Status code When
401 unauthorized The Authorization: Bearer … header is missing.
401 invalid_api_key The key does not exist.
401 revoked_api_key The key has been revoked.
401 expired_api_key The key has expired.
403 forbidden The key's scope is not enough for this route (see the scope badge).
429 rate_limited The per-minute request limit was exceeded.

The body of every error is { "error": { "code", "message", "details"? } }. See all error codes.

Try it

Try it

The live test uses your key and your account. It stays off when you are not signed in.

Sign in to try it
Question or mistake on this page? contato@praeko.appView .md

Type to search pages, routes and error codes.