Misc
Get top posts statistics
Returns the current user's top-performing posts statistics for a date range. Sibling calls fetch top story/stream/stream stats. OnlyFans only — Fansly accounts are rejected…
Returns the current user's top-performing posts statistics for a date range. Sibling calls fetch top story/stream/stream stats. 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
Start of the date range
endDate?string
End of the date range
skip_users?string
Whether to omit expanded user objects (set to 'all')
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/post" \ -H "user-id: 509955039"{ "success": true, "status_code": 0, "data": { "purchases": null, "tips": { "author": { "view": "string", "avatar": "string", "avatarThumbs": {}, "header": "string", "headerSize": {}, "headerThumbs": {}, "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, "hasStripe": true, "isStripeExist": true, "subscriptionBundles": [], "canSendChatToAll": true, "creditsMin": 0, "creditsMax": 0, "isPaywallPassed": true, "creditsMinAlternatives": 0, "payPalStatus": [], "canCreateLists": true, "showMediaCount": true, "showPostsInFeed": true, "subscribedBy": true, "canTrialSend": true }, "responseType": "string", "id": 0, "postedAt": "string", "postedAtPrecise": "string", "text": "string", "isMarkdownDisabled": true, "canDelete": true, "canComment": true, "canEdit": true, "favoritesCount": 0, "mediaCount": 0, "isMediaReady": true, "isOpened": true, "canToggleFavorite": true, "stats": { "isAvailable": true, "hasStats": true, "hasVideo": true, "hasAudio": true, "lookCount": 0, "uniqueLookCount": 0, "uniqueLookChart": [], "lookChart": [], "lookDuration": 0, "lookDurationAverage": 0, "likeCount": 0, "likeChart": [], "commentCount": 0, "commentChart": [], "tipCount": 0, "tipChart": [], "tipSum": 0, "purchasedCount": 0, "purchasedSumm": 0, "videoPlayCount": 0, "videoPlayDuration": 0, "videoPlayDurationAverage": 0 }, "commentsCount": 0, "tipsAmount": "string", "rawText": "string", "tweetSend": true, "media": [ {} ], "canViewMedia": true, "labelStates": [ {} ] }, "views": { "author": { "view": "string", "avatar": "string", "avatarThumbs": {}, "header": "string", "headerSize": {}, "headerThumbs": {}, "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, "hasStripe": true, "isStripeExist": true, "subscriptionBundles": [], "canSendChatToAll": true, "creditsMin": 0, "creditsMax": 0, "isPaywallPassed": true, "creditsMinAlternatives": 0, "payPalStatus": [], "canCreateLists": true, "showMediaCount": true, "showPostsInFeed": true, "subscribedBy": true, "canTrialSend": true }, "responseType": "string", "id": 0, "postedAt": "string", "postedAtPrecise": "string", "text": "string", "isMarkdownDisabled": true, "canDelete": true, "canComment": true, "canEdit": true, "isPinned": true, "favoritesCount": 0, "mediaCount": 0, "isMediaReady": true, "isOpened": true, "canToggleFavorite": true, "stats": { "isAvailable": true, "hasStats": true, "hasVideo": true, "hasAudio": true, "lookCount": 0, "uniqueLookCount": 0, "uniqueLookChart": [], "lookChart": [], "lookDuration": 0, "lookDurationAverage": 0, "likeCount": 0, "likeChart": [], "commentCount": 0, "commentChart": [], "tipCount": 0, "tipChart": [], "tipSum": 0, "purchasedCount": 0, "purchasedSumm": 0, "videoPlayCount": 0, "videoPlayDuration": 0, "videoPlayDurationAverage": 0 }, "commentsCount": 0, "tipsAmount": "string", "rawText": "string", "tweetSend": true, "media": [ {} ], "canViewMedia": true, "labelStates": [ {} ] }, "likes": { "author": { "view": "string", "avatar": "string", "avatarThumbs": {}, "header": "string", "headerSize": {}, "headerThumbs": {}, "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, "hasStripe": true, "isStripeExist": true, "subscriptionBundles": [], "canSendChatToAll": true, "creditsMin": 0, "creditsMax": 0, "isPaywallPassed": true, "creditsMinAlternatives": 0, "payPalStatus": [], "canCreateLists": true, "showMediaCount": true, "showPostsInFeed": true, "subscribedBy": true, "canTrialSend": true }, "responseType": "string", "id": 0, "postedAt": "string", "postedAtPrecise": "string", "text": "string", "isMarkdownDisabled": true, "canDelete": true, "canComment": true, "canEdit": true, "isPinned": true, "favoritesCount": 0, "mediaCount": 0, "isMediaReady": true, "isOpened": true, "canToggleFavorite": true, "stats": { "isAvailable": true, "hasStats": true, "hasVideo": true, "hasAudio": true, "lookCount": 0, "uniqueLookCount": 0, "uniqueLookChart": [], "lookChart": [], "lookDuration": 0, "lookDurationAverage": 0, "likeCount": 0, "likeChart": [], "commentCount": 0, "commentChart": [], "tipCount": 0, "tipChart": [], "tipSum": 0, "purchasedCount": 0, "purchasedSumm": 0, "videoPlayCount": 0, "videoPlayDuration": 0, "videoPlayDurationAverage": 0 }, "commentsCount": 0, "tipsAmount": "string", "rawText": "string", "tweetSend": true, "media": [ {} ], "canViewMedia": true, "labelStates": [ {} ] }, "comments": { "author": { "view": "string", "avatar": "string", "avatarThumbs": {}, "header": "string", "headerSize": {}, "headerThumbs": {}, "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, "hasStripe": true, "isStripeExist": true, "subscriptionBundles": [], "canSendChatToAll": true, "creditsMin": 0, "creditsMax": 0, "isPaywallPassed": true, "creditsMinAlternatives": 0, "payPalStatus": [], "canCreateLists": true, "showMediaCount": true, "showPostsInFeed": true, "subscribedBy": true, "canTrialSend": true }, "responseType": "string", "id": 0, "postedAt": "string", "postedAtPrecise": "string", "isMarkdownDisabled": true, "canDelete": true, "canComment": true, "canEdit": true, "favoritesCount": 0, "mediaCount": 0, "isMediaReady": true, "isOpened": true, "canToggleFavorite": true, "stats": { "isAvailable": true, "hasStats": true, "hasVideo": true, "hasAudio": true, "lookCount": 0, "uniqueLookCount": 0, "uniqueLookChart": [], "lookChart": [], "lookDuration": 0, "lookDurationAverage": 0, "likeCount": 0, "likeChart": [], "commentCount": 0, "commentChart": [], "tipCount": 0, "tipChart": [], "tipSum": 0, "purchasedCount": 0, "purchasedSumm": 0 }, "commentsCount": 0, "tipsAmount": "string", "tweetSend": true, "media": [ {} ], "canViewMedia": true } }}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…
Get top stories stats GET
Retrieves top-performing story statistics over a date range. OnlyFans only — Fansly accounts are rejected on /api2/v2/.