Get fan insights

1 import requests 2 3 url = "https://api.fanvue.com/insights/fans/userUuid" 4 5 headers = { 6 "X-Fanvue-API-Version": "2025-06-26", 7 "Authorization": "Bearer <token>" 8 } 9 10 response = requests.get(url, headers=headers) 11 12 print(response.json())

1 { 2 "status": "subscriber", 3 "spending": { 4 "lastPurchaseAt": "2024-01-14T00:00:00.000Z", 5 "total": { 6 "gross": 27700 7 }, 8 "maxSinglePayment": { 9 "gross": 5000 10 }, 11 "sources": { 12 "message": { 13 "gross": 15000 14 }, 15 "post": { 16 "gross": 8500 17 }, 18 "referral": { 19 "gross": 4200 20 } 21 } 22 }, 23 "subscription": { 24 "createdAt": "2024-01-01T12:00:00.000Z", 25 "renewsAt": "2024-02-01T00:00:00.000Z", 26 "autoRenewalEnabled": true 27 } 28 }

Returns detailed insights about a specific fan for the authenticated creator, including spending statistics, subscription status, and fan engagement metrics.

Scopes required: read:insights, read:fan

Returns detailed insights about a specific fan for the authenticated creator, including spending statistics, subscription status, and fan engagement metrics. <Info>Scopes required: `read:insights`, `read:fan`</Info>

Authentication

AuthorizationBearer

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

Path Parameters

userUuidstringRequiredformat: "uuid"

Fan's UUID

Response

Fan insights data

statusenum

Current fan status

Allowed values:

spendingobject

subscriptionobject

Authentication

Path Parameters

Headers

Response

Errors