curl --request GET \
  --url https://api.example.com/insights/fan-retention-summary \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'

import requests

url = "https://api.example.com/insights/fan-retention-summary"

headers = {
    "X-Fanvue-API-Version": "<x-fanvue-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'X-Fanvue-API-Version': '<x-fanvue-api-version>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://api.example.com/insights/fan-retention-summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "snapshots": [
    {
      "periodStart": "2026-03-16T00:00:00.000Z",
      "paidActiveFansCount": 1240,
      "prevPaidActiveFansCount": 1180,
      "paidChurnedFansCount": 95,
      "paidRetainedFansCount": 1085,
      "paidNewFansCount": 120,
      "paidReactivatedFansCount": 35,
      "paidFanChurnRate": 0.08,
      "paidFanNrr": 1.04,
      "paidReactivationRate": 0.03,
      "revenueCurrent": 1860000,
      "revenuePrevious": 1770000,
      "revenueRetained": 1627500,
      "revenueLost": 142500,
      "revenueNewFans": 180000,
      "revenueReactivatedFans": 52500,
      "ltvSimple": 18750,
      "ltvWeighted": 21300,
      "totalUniqueFans": 4820,
      "freeActiveFansCount": 3580,
      "freeRetainedFansCount": 3210,
      "freeNewFansCount": 410,
      "freeReactivatedFansCount": 60,
      "freeChurnedFansCount": 300,
      "freeFanChurnRate": 0.08,
      "freeToPaidConversionCount": 48,
      "totalActiveFansCount": 4820,
      "weeklyPostCount": 9,
      "weeklyPostingDays": 5,
      "weeklySubscriberOnlyPosts": 4,
      "weeklyFreePosts": 3,
      "weeklyPpvPosts": 2,
      "weeklyAvgMediaPerPost": 2.4,
      "weeklyPctPostsWithMedia": 0.89,
      "weeklyAvgLikesPerPost": 156,
      "weeklyAvgCommentsPerPost": 23,
      "weeklySingleMessagesSent": 540,
      "weeklyBroadcastMessagesSent": 3,
      "weeklyUniqueFansMessaged": 310,
      "weeklyAvgResponseTimeHours": 1.6,
      "weeklyPctRespondedWithin1h": 0.62,
      "weeklyPctRespondedWithin4h": 0.85,
      "weeklyPctRespondedWithin12h": 0.95,
      "weeklyFansRespondedCount": 290,
      "weeklyFanResponseRate": 0.94
    },
    {
      "periodStart": "2026-03-09T00:00:00.000Z",
      "paidActiveFansCount": 1180,
      "prevPaidActiveFansCount": 1150,
      "paidChurnedFansCount": 88,
      "paidRetainedFansCount": 1062,
      "paidNewFansCount": 90,
      "paidReactivatedFansCount": 28,
      "paidFanChurnRate": 0.077,
      "paidFanNrr": 1.02,
      "paidReactivationRate": 0.024,
      "revenueCurrent": 1770000,
      "revenuePrevious": 1725000,
      "revenueRetained": 1593000,
      "revenueLost": 132000,
      "revenueNewFans": 135000,
      "revenueReactivatedFans": 42000,
      "ltvSimple": 18200,
      "ltvWeighted": 20600,
      "totalUniqueFans": 4710,
      "freeActiveFansCount": 3470,
      "freeRetainedFansCount": 3160,
      "freeNewFansCount": 360,
      "freeReactivatedFansCount": 50,
      "freeChurnedFansCount": 310,
      "freeFanChurnRate": 0.082,
      "freeToPaidConversionCount": 41,
      "totalActiveFansCount": 4710,
      "weeklyPostCount": 7,
      "weeklyPostingDays": 4,
      "weeklySubscriberOnlyPosts": 3,
      "weeklyFreePosts": 3,
      "weeklyPpvPosts": 1,
      "weeklyAvgMediaPerPost": 2.1,
      "weeklyPctPostsWithMedia": 0.86,
      "weeklyAvgLikesPerPost": 142,
      "weeklyAvgCommentsPerPost": 19,
      "weeklySingleMessagesSent": 505,
      "weeklyBroadcastMessagesSent": 2,
      "weeklyUniqueFansMessaged": 295,
      "weeklyAvgResponseTimeHours": 1.9,
      "weeklyPctRespondedWithin1h": 0.58,
      "weeklyPctRespondedWithin4h": 0.82,
      "weeklyPctRespondedWithin12h": 0.93,
      "weeklyFansRespondedCount": 276,
      "weeklyFanResponseRate": 0.92
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "nextVersion": "<string>"
}

{
  "error": "<string>"
}