Skip to main content
GET
/
api
/
late
/
analytics
Get follower-growth analytics across all accounts
curl --request GET \
  --url https://app.puffle.ai/api/late/analytics \
  --header 'Authorization: Bearer <token>'
{
  "accounts": [
    {
      "platform": "<string>",
      "accountId": "<string>",
      "username": "<string>",
      "displayName": "<string>"
    }
  ],
  "stats": {},
  "dateRange": {
    "from": "<string>",
    "to": "<string>"
  },
  "granularity": "day"
}

​
Overview

Fetches follower/connection growth series from Late for every profile the caller owns, then merges the accounts list and stats map into a single response. Use this for dashboard-style follower charts. Query parameters:
  • fromDate, toDate — optional ISO date bounds for the window. If omitted, Late picks a default.
  • granularity — day (default), week, or month. Controls the bucket size of the stats series.

​
AI agent notes

~24h lag — platform follower counts trail the live counters by roughly 24 hours. Do not treat this endpoint as a real-time reader.Analytics add-on — requires the Late analytics add-on on the caller’s plan. Absent add-on returns 402 with code: "analytics_addon_required" — surface this to the human and offer to upgrade.Empty profiles — a caller with zero Late profiles returns 404, not 200 with an empty envelope. Check before calling.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
fromDate
string

Inclusive lower bound of the window (ISO date). If omitted, Late picks a default range.

​
toDate
string

Inclusive upper bound of the window (ISO date). If omitted, Late picks a default range.

​
granularity
enum<string>

Bucket size for the stats series. Defaults to day.

Available options:
day,
week,
month

Response

Merged follower stats.

​
accounts
object[]
required

Per-account metadata aggregated across every Late profile owned by the caller.

​
stats
object
required

Keyed by bucket (e.g. date string); values are the per-bucket follower metrics returned by Late. Shape is pass-through.

​
dateRange
object
required
​
granularity
enum<string>
required
Available options:
day,
week,
month