API referenceAnalytics
GET /accounts/follower-stats
Follower history per account from daily snapshots (the worker reads each account once per UTC day) with current count and growth over the window
GET
BearerAuthheader
AuthorizationBearer <token>API key sk_...
accountIds?stringComma-separated account ids
profileId?stringOnly this profile
fromDate?stringFirst day, YYYY-MM-DD (default: 30 days ago)
toDate?stringLast day, YYYY-MM-DD (default: today)
granularity?stringAggregation (default daily)
Value in
"daily""weekly""monthly"limit?integerMaximum items (default 25, max 100)
Range
1 <= value <= 100Default
25cursor?stringpagination.nextCursor
{accounts, stats, dateRange, granularity, pagination?}
application/json- response
accounts?array<>stats?{accountId: [{date, followers}]}
dateRange?granularity?stringpagination?curl -X GET 'https://example.com/api/v1/accounts/follower-stats'Example Response
{ "accounts": [ { "id": "string", "platform": "string", "accountName": "string", "profileId": "string", "currentFollowers": 0, "growth": 0, "growthPercentage": 0, "dataPoints": 0 } ], "stats": {}, "dateRange": { "from": "string", "to": "string" }, "granularity": "string", "pagination": { "nextCursor": "string", "hasMore": true }}