Get follower stats
Returns follower count history and growth metrics for connected accounts. Requires analytics add-on subscription. Follower counts are refreshed once per day.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
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"Value in
- "daily"
- "weekly"
- "monthly"
Accounts per page, ordered by account id. Send it to page through accounts; the response then carries pagination.nextCursor. Without limit or cursor every matching account is returned.
1 <= value <= 25Opaque cursor from a previous response's pagination.nextCursor; returns the next page of limit accounts (25 when limit is omitted). A cursor we cannot parse returns 400.
Response Body
application/json
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"}