FAfanvue

Get fan retention summary for a creator

Returns the specified creator's weekly fan-health snapshots, including paid/free active fans, churn, retention, reactivation, revenue retention, LTV, free-to-paid conversion, and engagement metrics. Snapshots are computed weekly by the data warehouse (not real-time); the most recent snapshot may be up to 7 days old.

get/creators/{creatorUserUuid}/insights/fan-retention-summary

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/insights/fan-retention-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

periodsinteger

Number of most-recent weekly snapshots to return (1-12, default: 6)

Headers

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

API version to use for the request

Response

Weekly fan retention snapshots

Changes

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