Get top-spending fans

Returns a paginated list of the top-spending fans for the authenticated creator with their spending totals and message counts.

get/insights/top-spenders

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/insights/top-spenders
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:insights, read:fan

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.

pageinteger

Page number to retrieve (starts from 1)

sizeinteger

Number of items to return per page (1-50, default: 15)

Headers

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

API version to use for the request

Response

Top spending fans with pagination

Changes

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