---
title: "Get follower stats"
method: GET
path: "/v1/accounts/follower-stats"
tags: ["Accounts", "Analytics"]
---

# Get follower stats

`GET /v1/accounts/follower-stats`

Returns follower count history and growth metrics for connected social accounts.
Requires analytics add-on subscription. Follower counts are refreshed once per day.

## Query parameters

- `accountIds` string
- `profileId` string
- `fromDate` string, date
- `toDate` string, date
- `granularity` 'daily' | 'weekly' | 'monthly'

## Response `200`

Follower stats

- FollowerStatsResponse
  - `accounts` AccountWithFollowerStats[]
    - `_id` string, required
    - `platform` 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads', required
    - `profileId` union, required
      - string
      - Profile
        - `_id` string
        - `userId` string
        - `name` string
        - `description` string
        - `color` string
        - `isDefault` boolean
        - `isOverLimit` boolean — Only present when includeOverLimit=true. Indicates if this profile exceeds the plan limit.
        - `createdAt` string, date-time
    - `username` string
    - `displayName` string
    - `profilePicture` string, nullable — URL to the account's profile picture on the platform. May be null if the platform does not provide one.
    - `profileUrl` string — Full profile URL for the connected account on its platform.
    - `isActive` boolean, required
    - `needsReconnection` boolean — The platform definitively reported the stored OAuth token as dead. While true, GET /v1/connect/{platform}/ads returns a fresh authUrl (implicit force=true) instead of alreadyConnected, so re-running the connect flow recovers the account. Cleared automatically when the account is re-authorized.
    - `followersCount` number — Follower count (only included if user has analytics add-on)
    - `followersLastUpdated` string, date-time — Last time follower count was updated (only included if user has analytics add-on)
    - `parentAccountId` string, nullable — Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts.
    - `enabled` boolean — Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., posting account auto-created when user connected ads first). Posting UI and scheduler ignore accounts with enabled: false.
    - `metadata` object — Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes: - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN) - nameStatus: Display name review status (APPROVED, PENDING_REVIEW, DECLINED, or NONE). A declined or pending display name does not by itself block sending; sendability is reported separately via health_status (can_send_message). - messagingLimitTier: Maximum unique business-initiated conversations per 24h rolling window (TIER_250, TIER_1K, TIER_10K, TIER_100K, or TIER_UNLIMITED). Scales automatically as quality rating improves. - verifiedName: Meta-verified business display name - displayPhoneNumber: Formatted phone number (e.g., "+1 555-123-4567") - wabaId: WhatsApp Business Account ID - phoneNumberId: Meta phone number ID For LinkedIn accounts, profileData carries the profile details refreshed on each daily snapshot: - profileData.bio: The member's headline for personal accounts, or the organization description for organization accounts. null when the member has not set one. - profileData.extraData.vanityName: The member's profile slug, i.e. the /in/{vanityName} segment of profileUrl. Personal accounts only; an organization's own slug is in metadata.organizationInfo.vanityName.
    - `currentFollowers` number — Current follower count
    - `lastUpdated` string, date-time
    - `growth` number — Follower change over period
    - `growthPercentage` number — Percentage growth
    - `dataPoints` number — Number of historical snapshots
    - `accountStats` object — Platform-specific account stats from the latest daily snapshot. Fields vary by platform. Only present if metadata has been captured.
      - `followingCount` number — Number of accounts being followed
      - `mediaCount` number — Total media posts (Instagram)
      - `videoCount` number — Total videos (YouTube, TikTok)
      - `tweetCount` number — Total tweets (X/Twitter)
      - `postsCount` number — Total posts (Bluesky)
      - `pinCount` number — Total pins (Pinterest)
      - `totalViews` number — Total channel views (YouTube)
      - `likesCount` number — Total likes received (TikTok)
      - `monthlyViews` number — Monthly profile views (Pinterest)
      - `listedCount` number — Lists the user appears on (X/Twitter)
      - `boardCount` number — Total boards (Pinterest)
  - `stats` object
  - `dateRange` object
    - `from` string, date-time
    - `to` string, date-time
  - `granularity` string

## Other responses

- `401` — Unauthorized
- `403` — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)