accounts
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.
AuthorizationBearer <token>
API key authentication - use your Late 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)
Format
datetoDate?string
End date in YYYY-MM-DD format (defaults to today)
Format
dategranularity?string
Data aggregation level
Default
"daily"Value in
"daily" | "weekly" | "monthly"Response Body
application/json
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/accounts/follower-stats"{
"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
}