FAfanvue

Get aggregated earnings summary for a creator

Returns pre-aggregated earnings metrics for the specified creator, including all-time totals, month-over-month comparisons, source/type breakdowns, chart series, and averages.

get/creators/{creatorUserUuid}/insights/earnings/summary

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/insights/earnings/summary
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator, read:insights

Path parameters

creatorUserUuidstring uuid required

Query parameters

startDatestring date-time

Start date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-20T00:00:00+01:00 or 2024-10-20T00:00:00Z).

endDatestring date-time

End date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-25T00:00:00+01:00 or 2024-10-25T00:00:00Z). Non-inclusive - data before this date is included.

granularity'day' | 'week'

Aggregation granularity for the over-time chart

timezonestring

IANA timezone used for period grouping and month boundaries (e.g., Europe/London, America/New_York)

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Creator aggregated earnings summary

averageByHourOfDayobject required

Average gross earnings by hour-of-day in the selected timezone (0-23)

Changes

No recorded changes to this operation across all 8 revisions of this API.