Get fan retention summary

Returns the authenticated 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/insights/fan-retention-summary

Query parameters

periodsinteger

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

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