Get aggregated earnings summary for a creator

curl https://api.fanvue.com/creators/creatorUserUuid/insights/earnings/summary \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "totals": {
    "allTime": {
      "gross": 1250000,
      "net": 1037500
    },
    "thisMonth": {
      "gross": 120000,
      "net": 99000,
      "previousMonthGross": 100000,
      "previousMonthNet": 82500,
      "grossChangePercentage": 20,
      "netChangePercentage": 20
    }
  },
  "breakdownBySource": {
    "subs": {
      "gross": 50000,
      "net": 41250
    },
    "messages": {
      "gross": 15000,
      "net": 12375
    },
    "posts": {
      "gross": 25000,
      "net": 20625
    },
    "tips": {
      "gross": 12000,
      "net": 9900
    },
    "referrals": {
      "gross": 4000,
      "net": 3300
    },
    "renewals": {
      "gross": 10000,
      "net": 8250
    },
    "other": {
      "gross": 4000,
      "net": 3300
    }
  },
  "earningsByType": {
    "renewals": {
      "gross": 10000,
      "net": 8250
    },
    "messages": {
      "gross": 15000,
      "net": 12375
    },
    "tips": {
      "gross": 12000,
      "net": 9900
    },
    "subs": {
      "gross": 50000,
      "net": 41250
    }
  },
  "overTime": [
    {
      "periodStart": "2026-03-01T00:00:00.000Z",
      "gross": 24000,
      "net": 19800
    },
    {
      "periodStart": "2026-03-02T00:00:00.000Z",
      "gross": 18000,
      "net": 14850
    }
  ],
  "averageByDayOfWeek": {
    "1": 11000,
    "2": 9500,
    "3": 10250,
    "4": 9800,
    "5": 12000,
    "6": 8700,
    "7": 9100
  },
  "averageByHourOfDay": {
    "0": 0,
    "1": 0,
    "2": 0,
    "3": 0,
    "4": 0,
    "5": 0,
    "6": 0,
    "7": 0,
    "8": 1200,
    "9": 2300,
    "10": 2800,
    "11": 3200,
    "12": 3500,
    "13": 3700,
    "14": 4200,
    "15": 3900,
    "16": 3300,
    "17": 3000,
    "18": 2600,
    "19": 2100,
    "20": 1700,
    "21": 1300,
    "22": 900,
    "23": 400
  },
  "period": {
    "startDate": "2026-03-01T00:00:00.000Z",
    "endDate": "2026-04-01T00:00:00.000Z",
    "granularity": "day",
    "timezone": "UTC"
  }
}

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

Scopes required: read:creator, read:insights

Returns pre-aggregated earnings metrics for the specified creator, including all-time totals, month-over-month comparisons, source/type breakdowns, chart series, and averages. <Info>Scopes required: `read:creator`, `read:insights`</Info>

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Query parameters

startDatestringOptionalformat: "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).

endDatestringOptionalformat: "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.

granularityenumOptionalDefaults to day

Aggregation granularity for the over-time chart

Allowed values:

timezonestringOptionalDefaults to UTC

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

Response

Creator aggregated earnings summary

totalsobject

breakdownBySourceobject

earningsByTypeobject

overTimelist of objects

averageByDayOfWeekobject

Average gross earnings by ISO day-of-week (1=Monday, 7=Sunday)

averageByHourOfDaymap from strings to doubles

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

periodobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error