Get the analytics summary

GET 
/:workspace/analytics

Returns the cross-platform analytics of the workspace for a period, across every connected account that supports analytics: total followers, follower growth and post count compared with the previous period of the same length, the best and the least growing account, a daily audience chart, a follower leaderboard, the follower distribution and posting consistency.

The period is either a named period or a custom range given by date_from and date_to together; a custom range wins over period. Every date is a UTC day, and every chart is a list of {date, value} points with one point per day of the range. value is null on a day with no recorded audience.

Available to every workspace role, including VIEWER.

Request

Responses

200

The analytics summary.

401

The bearer token is missing, malformed, unknown, or expired.

403

The token is valid, but the user it belongs to may not perform this action:

• they are not a member of the {workspace} in the path; or
• their workspace role is too low for this endpoint (write routes require Admin or Member); or
• for /panel endpoints, they are not a platform administrator.

The host application that Mixpost is installed into can also deny access to Mixpost as a whole, which produces the same response.

404

The {workspace} UUID in the path does not match any workspace.

422

The period failed validation: an unknown period, only one of date_from and date_to, an end before the start, or a range longer than 366 days.