FanvueFans
Get Fan Insights
Get one fan's relationship with the creator: their status, what they have spent and how, and their subscription renewal. Proxies Fanvue's GET /v1/insights/fans/{userUuid}.
Every money figure comes gross and net, net meaning refunded and charged-back purchases removed. spending.total.total has always been net of reversals, so the gross per-source figures can add up to more than it and the gap is exactly the reversals.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
fanvueAccount*string
The Fanvue Account ID
userUuid*string
The fan's Fanvue user UUID.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fanvue/fanvue_acct_XXXXXXXXXXXXXXX/fans/f47ac10b-58cc-4372-a567-0e02b2c3d479/insights"{
"data": {
"status": "subscriber",
"spending": {
"lastPurchaseAt": "2026-09-22T10:29:07.224Z",
"lastValidPurchaseAt": "2026-09-22T10:29:07.224Z",
"total": {
"gross": 536,
"total": 536,
"netTotal": 536
},
"maxSinglePayment": {
"gross": 536,
"total": 536
},
"sources": {
"subscription": {
"gross": 536,
"total": 536,
"netTotal": 536,
"count": 1,
"netCount": 1,
"average": 536,
"netAverage": 536
}
}
},
"subscription": {
"createdAt": "2026-09-22T10:29:07.224Z",
"renewsAt": "2026-10-22T10:28:59.873Z",
"autoRenewalEnabled": true
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055811,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}