Get 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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIds?string

Comma-separated list of account IDs (optional, defaults to all user's accounts)

profileId?string

Filter by profile ID

fromDate?string

Start date in YYYY-MM-DD format (defaults to 30 days ago)

Formatdate

toDate?string

End date in YYYY-MM-DD format (defaults to today)

Formatdate

granularity?string

Data aggregation level

Default"daily"

Value in"daily" | "weekly" | "monthly"

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.accounts.getFollowerStats();console.log(data);

{
  "accounts": [
    {
      "_id": "64e1...",
      "platform": "twitter",
      "username": "@acme",
      "currentFollowers": 1250,
      "growth": 50,
      "growthPercentage": 4.17,
      "dataPoints": 30
    }
  ],
  "stats": {
    "64e1...": [
      {
        "date": "2024-01-01",
        "followers": 1200
      },
      {
        "date": "2024-01-02",
        "followers": 1250
      }
    ]
  },
  "dateRange": {
    "from": "2024-01-01T00:00:00.000Z",
    "to": "2024-01-31T23:59:59.999Z"
  },
  "granularity": "daily"
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "message": "Follower stats tracking requires the Analytics add-on. Please upgrade to access this feature.",
  "requiresAddon": true
}

Get 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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

accountIds?string

Comma-separated list of account IDs (optional, defaults to all user's accounts)

profileId?string

Filter by profile ID

fromDate?string

Start date in YYYY-MM-DD format (defaults to 30 days ago)

Formatdate

toDate?string

End date in YYYY-MM-DD format (defaults to today)

Formatdate

granularity?string

Data aggregation level

Default"daily"

Value in"daily" | "weekly" | "monthly"

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.accounts.getFollowerStats();
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.accounts.getFollowerStats();console.log(data);

{
  "accounts": [
    {
      "_id": "64e1...",
      "platform": "twitter",
      "username": "@acme",
      "currentFollowers": 1250,
      "growth": 50,
      "growthPercentage": 4.17,
      "dataPoints": 30
    }
  ],
  "stats": {
    "64e1...": [
      {
        "date": "2024-01-01",
        "followers": 1200
      },
      {
        "date": "2024-01-02",
        "followers": 1250
      }
    ]
  },
  "dateRange": {
    "from": "2024-01-01T00:00:00.000Z",
    "to": "2024-01-31T23:59:59.999Z"
  },
  "granularity": "daily"
}

{
  "error": "Unauthorized"
}

{
  "error": "Analytics add-on required",
  "message": "Follower stats tracking requires the Analytics add-on. Please upgrade to access this feature.",
  "requiresAddon": true
}

Get follower stats

Authorization

Query Parameters

Response Body

200application/json

401application/json

403application/json

Get follower stats

Authorization

Query Parameters

Response Body

200application/json

401application/json

403application/json

application/json

application/json

application/json

application/json

application/json

application/json