Skip to content

Follower Count API

The Follower Count API returns a connected account's current follower count, normalised to a single followers number across platforms. For YouTube, that same field represents the subscriber count, while elsewhere it represents followers. Use this endpoint when you need one consistent field for a connected account instead of handling a different count name for each platform.

Follower Count API - normalized follower/subscriber count for a connected account

This endpoint returns the current follower count for one connected account. The result is normalised so client code can read the followers field without switching field names by platform. On YouTube, interpret that value as the subscriber count; on the other supported platforms, interpret it as followers. Supported platforms are facebook, instagram, linkedin, youtube, pinterest, and bluesky. LinkedIn company pages are supported for this count, while LinkedIn member profiles are not available from LinkedIn's API. Threads and TikTok do not expose a usable follower count under current access. The followers value is null when the platform or account type cannot report it, or when the account hides its count, so clients should treat null as an unavailable count rather than as zero.

Request - GET {{API_BASE_URL}}/v1/analytics/followers

Send a GET request to the endpoint shown in the Follower Count API request example, using {{API_BASE_URL}} as the origin and keeping the path and query string unchanged. Include the x-access-key header with your access key. Both query parameters are required: platform selects the supported platform and accountId identifies the connected account. Before calling, confirm that accountId is the Integration ID of the connected account from list_integrations, and confirm that platform uses one of the exact supported values in the query parameters table. Check both required parameters before submitting, and inspect the actual response rather than assuming a missing input has a documented error shape.

Query parameters - platform and accountId field map

The query parameters table is the field map for this endpoint. platform is a required string and must be facebook, instagram, linkedin, youtube, pinterest, or bluesky. accountId is a required string and must be the Integration ID of the connected account from list_integrations. Keep the parameter names exactly as platform and accountId, including the capital I in accountId, because the endpoint contract depends on those names.

Response - success, platform, accountId, followers JSON contract

A successful response returns success, platform, accountId, and followers, as shown in the Follower Count API response example. The followers field is the current count: subscribers on YouTube and followers elsewhere. Echoed platform and accountId values let the client confirm which connected account the count belongs to before storing or displaying it. Each successful call costs 1 credit. When followers is null, handle it as an unavailable count for that platform or account type, including cases where the account hides its count, rather than converting it to zero or substituting a count from another platform.

Platform availability and null cases

Use the normalised followers field when your client needs the same count shape across supported platforms. Use platform-specific handling only for the documented limits: LinkedIn company pages only, no usable Threads or TikTok count under current access, and null when a platform, account type, or hidden-count setting cannot report a value. For broader post performance across connected platforms, the related Get Analytics reference covers performance metrics, and Google Business Performance covers location-level metrics for a connected Google Business Profile.

Query parameters
ParameterTypeRequiredDescription
platformstringYesfacebook, instagram, linkedin, youtube, pinterest, or bluesky
accountIdstringYesIntegration ID of the connected account from list_integrations

Exact source field map preserved.

Follower Count API request
GET {{API_BASE_URL}}/v1/analytics/followers?platform=youtube&accountId=INTEGRATION_ID
x-access-key: YOUR_ACCESS_KEY
Follower Count API response example
{
	"success": true,
	"platform": "youtube",
	"accountId": "INTEGRATION_ID",
	"followers": 21
}
Endpoint request 1
GET /v1/analytics/followers?platform=youtube&accountId=INTEGRATION_ID
x-access-key: YOUR_ACCESS_KEY