Get agency insights headline metrics
Returns the headline metrics for the authenticated user's agency: total earnings, newly acquired fans, average revenue per paying fan, the 30-day retention snapshot and average fan lifetime, aggregated across every creator the agency manages.
Figures come from the daily warehouse export, so they lag live platform data by up to a day. All money is USD cents; rates are fractions, not percentages.
totalEarnings and arpu are not two views of one number and will not reconcile. totalEarnings is what the agency's creators earned, excluding refunds and chargebacks, and includes money with no fan behind it such as referrals. arpu measures what fans paid, so it drops those and subtracts reversals — the same definition the creator-level /insights/top-spenders uses. Expect arpu.grossSpend to be the smaller figure.
retention and averageFanLifetime are snapshots computed on the warehouse's own windows — the 30-day cohort and all-time respectively — so startDate/endDate do not affect them.
No comparison period is returned: to show a change against the preceding period, request the same endpoint again for that range. <Info>Requires: Agency admin access</Info>
Query parameters
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
Comma-separated list of creator UUIDs (max 50)
Comma-separated list of creator UUIDs to restrict results to a subset of the agency's managed creators (max 50). Every uuid must belong to the agency: one that does not fails the whole request with 403 rather than being ignored.
Headers
API version to use for the request
Response
Agency insights headline metrics