Get Follower Count API
The Get Follower Count API returns a connected account's current follower or subscriber count for a single platform and account. Use it when a dashboard, report, or automation needs the latest followers value without fetching a broader analytics payload, and handle the documented null case explicitly in your client.
Get Follower Count API overview
The Get Follower Count API returns a connected account's current follower or subscriber count. Supported platforms are facebook, instagram, linkedin, youtube, pinterest, and bluesky. LinkedIn returns a count for company pages only, so do not expect the same result for personal LinkedIn profiles. Each successful call costs 1 credit.
The followers field is null when the platform does not provide a count for that account type, or when the count is hidden. Treat null as a valid 200 response rather than an error: store it as unavailable, display a neutral placeholder in user interfaces, and avoid arithmetic or sorting that assumes a number. Only use the numeric value when followers is a number.
To make the call, send a GET request to {{API_BASE_URL}}/v1/analytics/followers with the required query parameters described in the Request example below. Supply the platform enum value exactly as listed and the Integration ID of the connected account as accountId. Verify both values before sending, because the request cannot succeed without them.
For authorization, include the x-access-key header with your token value. Keep the token out of client-side code, logs, and example output.
On a 200 response, read success, platform, accountId, and followers from the JSON body. Branch on the type of followers before using it: a number is the current count, and null means no count is available for the reasons described above.
For non-200 responses, use the status matrix below to route handling without assuming an error code that the contract does not define. The documented error body shape contains success and message fields. Log the status and message for diagnosis, surface a generic failure to the user, and do not treat a 400, 402, 404, or 502 response as a follower count.
Request
Send the request as a GET to the followers endpoint with platform and accountId as query parameters. The platform value must be one of the supported enum values, and accountId must identify the connected account. The worked request example shows a facebook query; replace the placeholder values with your own platform and Integration ID of the connected account before running it.
Authorization
Include the x-access-key header on every request. The header carries the token that authorizes access to the connected account data.
Response Body
A successful response returns success as true, the requested platform, the requested accountId, and followers as either a number or null. The numeric example and the null example below show both valid shapes. Your client should preserve the distinction between zero, which is a reported count, and null, which means no count is available.
Error statuses
The status matrix lists every documented response status for this endpoint. Use it to separate a successful count from a failed request and to decide what to log or display. The error body shape is the same across the listed error statuses, so handle the message field generically and do not invent a specific error code for any status.
| Parameter | Required | Type | Description |
|---|---|---|---|
| platform | Yes | string | Platform to read followers for. LinkedIn returns a count for company pages only. Value in "facebook" | "instagram" | "linkedin" | "youtube" | "pinterest" | "bluesky" |
| accountId | Yes | string | Integration ID of the connected account. |
Exact source contract; origin modularized as {{API_BASE_URL}}.
| Field | Required | Type | Description |
|---|---|---|---|
| success | Yes | boolean | Indicates the response outcome as documented in the source contract. |
| platform | Yes | string | Platform that was queried. |
| accountId | Yes | string | Integration ID of the connected account that was queried. |
| followers | Yes | number | null | Current follower or subscriber count, or null when the platform does not provide a count for that account type, or when the count is hidden. |
Exact source contract for the 200 application/json response.
| Status | Content type | Body shape |
|---|---|---|
| 200 | application/json | success, platform, accountId, followers |
| 400 | application/json | success, message |
| 402 | application/json | success, message |
| 404 | application/json | success, message |
| 502 | application/json | success, message |
Statuses and body shape preserved from source; specific error codes, messages, and retry semantics are not defined in source and are not invented here.
curl -X GET "{{API_BASE_URL}}/v1/analytics/followers?platform=facebook&accountId=string" \
-H "x-access-key: <token>"{
"success": true,
"platform": "string",
"accountId": "string",
"followers": 0
}{
"success": true,
"platform": "string",
"accountId": "string",
"followers": null
}{
"success": true,
"message": "string"
}| Scope | Field | Type | Type reference | Required | Description | Constraints |
|---|---|---|---|---|---|---|
| platform#1 | platform | string | __0 | Yes | Platform to read followers for. LinkedIn returns a count for company pages only. | kind: schemaValueIn; value: "facebook" | "instagram" | "linkedin" | "youtube" | "pinterest" | "bluesky" |
| accountId#2 | accountId | string | __0 | Yes | Integration ID of the connected account. | |
| response#3 | response | object | __0 | |||
| response#3 | response.success | boolean | __1 | Yes | ||
| response#3 | response.platform | string | __2 | Yes | ||
| response#3 | response.accountId | string | __3 | Yes | ||
| response#3 | response.followers | number | null | __4 | Yes | ||
| response#3 | response.followers[variant1] | number | __4_type:number | |||
| response#3 | response.followers[variant2] | null | __4_type:null | |||
| response#4 | response | object | __0 | |||
| response#4 | response.success | boolean | __1 | Yes | ||
| response#4 | response.message | string | __2 | Yes |