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
}Get frequency vs engagement GET
Returns the correlation between posting frequency (posts per week) and engagement rate, broken down by platform. Helps find the optimal posting cadence for each platform. Each row represents a specific (platform, posts_per_week) combination with the average engagement rate observed across all weeks matching that frequency. Requires the Analytics add-on.
Get Instagram insights GET
Returns account-level Instagram insights such as reach, views, accounts engaged, and total interactions. These metrics reflect the entire account's performance across all content surfaces (feed, stories, explore, profile), and are fundamentally different from post-level metrics. Data may be delayed up to 48 hours. Max 90 days, defaults to last 30 days. Requires the Analytics add-on.