Sign in
Analytics

Get an analytics dashboard

Everything an analytics dashboard needs in one call: window totals, follower growth, a per-day series, top posts, recent posts and, optionally, the same figures for the previous period. Daily and total metrics use received attribution: each day holds the engagement that arrived that day, on any post, so totals is always the sum of daily. topPosts and recentPosts list posts published in the window with their lifetime metrics. A post cross-posted to several platforms appears once per platform. All dates are UTC days. Requires the Analytics add-on.

get/v1/analytics/dashboard

Query parameters

profileIdstring

Profile ID, or "all" for every profile you can access.

platformstring

Platform to cover (e.g. "instagram"), or "all".

fromDatestring date required
Example:2026-09-01

First day of the window (YYYY-MM-DD, inclusive).

toDatestring date required
Example:2026-09-30

Last day of the window (YYYY-MM-DD, inclusive). May equal fromDate. The window covers at most 366 days.

compare'previous_period'

Set to "previous_period" to also return previousTotals and previousFollowers for the window of the same length that ends the day before fromDate.

topPostsinteger

How many top posts to return, ranked by engagement (likes, comments, shares and saves, the same sum as daily engagement).

recentPostsinteger

How many of the most recently published posts to return.

Response

Dashboard for the window

dataAsOfstring date-time nullable required

When the most recently synced account in scope was last synced. Null if none has synced yet.

Changes

Changed in 2 of the 64 revisions of this API.9

  • d556591af3f68See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 42a5a2dd988a1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog