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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Comma-separated list of account IDs (optional, defaults to all user's accounts)
Filter by profile ID
Start date in YYYY-MM-DD format (defaults to 30 days ago)
dateEnd date in YYYY-MM-DD format (defaults to today)
dateData aggregation level
"daily""daily" | "weekly" | "monthly"Response Body
application/json
application/json
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
}Check accounts health GET
Returns health status of all connected accounts including token validity, permissions, and issues needing attention.
Get Slack account settings GET
Returns the connected Slack channel details and the default message identity (name and avatar shown as the author on every post, with Slack's APP badge). The identity applies to messages only; the app's own Slack profile is global and cannot be changed per workspace.