Misc
Get top fans stats
Returns the current user's top-fan statistics over a date range. OnlyFans only — Fansly accounts are rejected on /api2/v2/.
Returns the current user's top-fan statistics over a date range. OnlyFans only — Fansly accounts are rejected on /api2/v2/*.
✓ Verified live against a real OnlyFans account (2026-07-30); the data schema below is the real response shape.
Guide: The two surfaces
Authorization
apiKey X-API-Key<token>
Your CRM panel API key
In: header
Query Parameters
startDate*string
Range start date
endDate*string
Range end date
Header Parameters
user-id*string
Creator account ID of the account to act as (e.g. 509955039). Required — omitting it returns 400 user-id header is required. Use GET /accounts to list your connected accounts. On /api2/v2/* the account must be an OnlyFans account; Fansly accounts are rejected there.
X-Proxy?string
Proxy URL — HTTP or SOCKS5 (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Optional on post-connection routes, where it overrides the proxy saved at login time. Required on the connection routes (POST /accounts/login, POST /accounts/login/cookies, POST /accounts/login/verify-otp) for OnlyFans accounts; optional for Fansly.
Response Body
application/json
curl -X GET "https://example.com/api2/v2/users/me/stats/top/fan?startDate=string&endDate=string" \ -H "user-id: 509955039"{ "success": true, "status_code": 0, "data": { "total": { "view": "string", "avatar": null, "avatarThumbs": null, "header": null, "headerSize": null, "headerThumbs": null, "id": 0, "name": "string", "username": "string", "canLookStory": true, "canCommentStory": true, "hasNotViewedStory": true, "isVerified": true, "canPayInternal": true, "hasScheduledStream": true, "hasStream": true, "hasStories": true, "tipsEnabled": true, "tipsTextEnabled": true, "tipsMin": 0, "tipsMinInternal": 0, "tipsMax": 0, "canEarn": true, "canAddSubscriber": true, "subscribePrice": 0, "displayName": "string", "notice": "string", "isActive": true, "isRestricted": true, "canRestrict": true, "subscribedBy": true, "subscribedByExpire": true, "subscribedByExpireDate": "string", "subscribedByAutoprolong": true, "subscribedIsExpiredNow": true, "currentSubscribePrice": 0, "subscribedOn": null, "subscribedOnExpire": true, "subscribedOnExpiredNow": true, "subscribedOnDuration": "string", "listsStates": [ {} ], "canReport": true, "canReceiveChatMessage": true, "hideChat": true, "lastSeen": "string", "isPerformer": true, "isRealPerformer": true, "subscribedByData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": "string", "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "showPostsInFeed": true, "subscribes": [], "hasActivePaidSubscriptions": true }, "subscribedOnData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": null, "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "tipsSumm": 0, "subscribesSumm": 0, "messagesSumm": 0, "postsSumm": 0, "streamsSumm": 0, "totalSumm": 0, "subscribes": [], "hasActivePaidSubscriptions": true }, "canTrialSend": true, "isBlocked": true, "canUnsubscribe": true, "isPendingAutoprolong": true }, "subscriptions": { "view": "string", "avatar": null, "avatarThumbs": null, "header": null, "headerSize": null, "headerThumbs": null, "id": 0, "name": "string", "username": "string", "canLookStory": true, "canCommentStory": true, "hasNotViewedStory": true, "isVerified": true, "canPayInternal": true, "hasScheduledStream": true, "hasStream": true, "hasStories": true, "tipsEnabled": true, "tipsTextEnabled": true, "tipsMin": 0, "tipsMinInternal": 0, "tipsMax": 0, "canEarn": true, "canAddSubscriber": true, "subscribePrice": 0, "displayName": "string", "notice": "string", "isActive": true, "isRestricted": true, "canRestrict": true, "subscribedBy": true, "subscribedByExpire": true, "subscribedByExpireDate": "string", "subscribedByAutoprolong": true, "subscribedIsExpiredNow": true, "currentSubscribePrice": 0, "subscribedOn": null, "subscribedOnExpire": true, "subscribedOnExpiredNow": true, "subscribedOnDuration": "string", "listsStates": [ {} ], "canReport": true, "canReceiveChatMessage": true, "hideChat": true, "lastSeen": "string", "isPerformer": true, "isRealPerformer": true, "subscribedByData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": "string", "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "showPostsInFeed": true, "subscribes": [], "hasActivePaidSubscriptions": true }, "subscribedOnData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": null, "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "tipsSumm": 0, "subscribesSumm": 0, "messagesSumm": 0, "postsSumm": 0, "streamsSumm": 0, "totalSumm": 0, "subscribes": [], "hasActivePaidSubscriptions": true }, "canTrialSend": true, "isBlocked": true, "canUnsubscribe": true, "isPendingAutoprolong": true }, "tips": { "view": "string", "avatar": null, "avatarThumbs": null, "header": null, "headerSize": null, "headerThumbs": null, "id": 0, "name": "string", "username": "string", "canLookStory": true, "canCommentStory": true, "hasNotViewedStory": true, "isVerified": true, "canPayInternal": true, "hasScheduledStream": true, "hasStream": true, "hasStories": true, "tipsEnabled": true, "tipsTextEnabled": true, "tipsMin": 0, "tipsMinInternal": 0, "tipsMax": 0, "canEarn": true, "canAddSubscriber": true, "subscribePrice": 0, "displayName": "string", "notice": "string", "isActive": true, "isRestricted": true, "canRestrict": true, "subscribedBy": true, "subscribedByExpire": true, "subscribedByExpireDate": "string", "subscribedByAutoprolong": true, "subscribedIsExpiredNow": true, "currentSubscribePrice": 0, "subscribedOn": true, "subscribedOnExpire": true, "subscribedOnExpiredNow": true, "subscribedOnDuration": "string", "listsStates": [ {} ], "canReport": true, "canReceiveChatMessage": true, "hideChat": true, "lastSeen": "string", "isPerformer": true, "isRealPerformer": true, "subscribedByData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": "string", "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "showPostsInFeed": true, "subscribes": [], "hasActivePaidSubscriptions": true }, "subscribedOnData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": "string", "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "tipsSumm": 0, "subscribesSumm": 0, "messagesSumm": 0, "postsSumm": 0, "streamsSumm": 0, "totalSumm": 0, "subscribes": [], "hasActivePaidSubscriptions": true }, "canTrialSend": true, "isBlocked": true, "canUnsubscribe": true, "isPendingAutoprolong": true }, "messages": { "view": "string", "avatar": null, "avatarThumbs": null, "header": null, "headerSize": null, "headerThumbs": null, "id": 0, "name": "string", "username": "string", "canLookStory": true, "canCommentStory": true, "hasNotViewedStory": true, "isVerified": true, "canPayInternal": true, "hasScheduledStream": true, "hasStream": true, "hasStories": true, "tipsEnabled": true, "tipsTextEnabled": true, "tipsMin": 0, "tipsMinInternal": 0, "tipsMax": 0, "canEarn": true, "canAddSubscriber": true, "subscribePrice": 0, "displayName": "string", "notice": "string", "isActive": true, "isRestricted": true, "canRestrict": true, "subscribedBy": true, "subscribedByExpire": true, "subscribedByExpireDate": "string", "subscribedByAutoprolong": true, "subscribedIsExpiredNow": true, "currentSubscribePrice": 0, "subscribedOn": null, "subscribedOnExpire": true, "subscribedOnExpiredNow": true, "subscribedOnDuration": "string", "listsStates": [ {} ], "canReport": true, "canReceiveChatMessage": true, "hideChat": true, "lastSeen": "string", "isPerformer": true, "isRealPerformer": true, "subscribedByData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": "string", "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "showPostsInFeed": true, "subscribes": [], "hasActivePaidSubscriptions": true }, "subscribedOnData": { "price": 0, "newPrice": 0, "regularPrice": 0, "subscribePrice": 0, "discountPercent": 0, "discountPeriod": 0, "subscribeAt": "string", "expiredAt": "string", "renewedAt": null, "discountFinishedAt": null, "discountStartedAt": null, "status": null, "isMuted": true, "unsubscribeReason": "string", "duration": "string", "tipsSumm": 0, "subscribesSumm": 0, "messagesSumm": 0, "postsSumm": 0, "streamsSumm": 0, "totalSumm": 0, "subscribes": [], "hasActivePaidSubscriptions": true }, "canTrialSend": true, "isBlocked": true, "canUnsubscribe": true, "isPendingAutoprolong": true }, "streams": null }}Get messages statistics by type GET
Returns the current user's messaging statistics for a given type (default 'all') over a date range, paginated and searchable. OnlyFans only — Fansly accounts are rejected…
Get top messages stats GET
Returns statistics on the current user's top-performing messages over a date range. The {id} in path_raw is the appended querystring. OnlyFans only — Fansly accounts are…