Fans
List Top Fans
Get a list of top fans sorted by spending. Filterable by total, subscriptions, tips, messages, posts, or streams.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
account*string
The Account ID
Query Parameters
start_date?string|null
Start date for filtering (required with end_date). This field is required when end_date is present.
end_date?string|null
End date for filtering (required with start_date). This field is required when start_date is present.
by?string|null
Sort by: total (default), subscribes, tips, messages, post, streams.
Value in
"total" | "subscribes" | "tips" | "messages" | "post" | "streams"Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/fans/top?start_date=2024-01-01&end_date=2024-12-31&by=total"{
"data": {
"users": [
{
"view": "x",
"avatar": "https://public.onlyfans.com/files/l/la/lal/.../123/avatar.jpg",
"avatarThumbs": {
"c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/l/la/lal/.../123/avatar.jpg",
"c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/l/la/lal/.../123/avatar.jpg"
},
"header": null,
"headerSize": null,
"headerThumbs": null,
"id": 123,
"name": "name",
"username": "username",
"canLookStory": false,
"canCommentStory": false,
"hasNotViewedStory": false,
"isVerified": true,
"canPayInternal": true,
"hasScheduledStream": false,
"hasStream": false,
"hasStories": false,
"tipsEnabled": false,
"tipsTextEnabled": true,
"tipsMin": 5,
"tipsMinInternal": 1,
"tipsMax": 200,
"canEarn": true,
"canAddSubscriber": true,
"subscribePrice": 4.99,
"subscriptionBundles": [],
"displayName": "",
"notice": "",
"isPaywallRequired": true,
"isRestricted": false,
"canRestrict": true,
"subscribedBy": false,
"subscribedByExpire": null,
"subscribedByExpireDate": null,
"subscribedByAutoprolong": null,
"subscribedIsExpiredNow": null,
"currentSubscribePrice": null,
"subscribedOn": true,
"subscribedOnExpiredNow": false,
"subscribedOnDuration": "6 days",
"listsStates": [
{
"id": "following",
"type": "following",
"name": "Following",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "SYSTEM_LIST"
},
{
"id": "fans",
"type": "fans",
"name": "Fans",
"hasUser": true,
"canAddUser": false,
"cannotAddUserReason": "ALREADY_EXISTS"
}
],
"canReport": false,
"canReceiveChatMessage": true,
"hideChat": false,
"lastSeen": "2025-01-01T00:00:00+00:00",
"isPerformer": true,
"isRealPerformer": true,
"subscribedByData": null,
"subscribedOnData": {
"price": 0,
"newPrice": 0,
"regularPrice": 0,
"subscribePrice": 0,
"discountPercent": 0,
"discountPeriod": 1,
"subscribeAt": "2025-01-01T00:00:00+00:00",
"expiredAt": "2025-01-01T00:00:00+00:00",
"renewedAt": null,
"discountFinishedAt": null,
"discountStartedAt": null,
"status": "Set to Expire",
"isMuted": false,
"unsubscribeReason": "No reason given",
"duration": "6 days",
"tipsSumm": 500,
"subscribesSumm": 100,
"messagesSumm": 200,
"postsSumm": 50,
"streamsSumm": 25,
"totalSumm": 875,
"lastActivity": "2025-01-01T00:00:00+00:00",
"recommendations": 0
},
"canTrialSend": false,
"isBlocked": false
}
]
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999226,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 999,
"remaining_day": 49951
}
}
}