Fans
List Active Fans
Get a paginated list of fans for an Account. Newest fans are first.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
limit?string | null
Number of fans to return (1-50)
offset?string | null
Number of fans to skip
type?string | null
Filter by fan type
filter?object
Empty Object
filter.online?string | null
Filter by online status (1 for online)
filter.total_spent?string | null
Filter by minimum total spent
filter.tips?string | null
Filter by minimum tips
filter.duration?string | null
Filter by minimum subscription duration (days)
Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/fans/active?limit=20&offset=0&type=active&filter=&filter.online=1&filter.total_spent=100&filter.tips=50&filter.duration=30"{
"data": {
"list": [
{
"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"
},
{
"id": "recent",
"type": "recent",
"name": "Recent (last 24 hours)",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "SYSTEM_LIST"
},
{
"id": "tagged",
"type": "tagged",
"name": "Tagged",
"hasUser": false,
"canAddUser": false,
"cannotAddUserReason": "SYSTEM_LIST"
},
{
"id": "friends",
"type": "friends",
"name": "Friends",
"hasUser": false,
"canAddUser": true,
"cannotAddUserReason": null
},
{
"id": "muted",
"type": "muted",
"name": "Muted",
"hasUser": false,
"canAddUser": true,
"cannotAddUserReason": null
}
],
"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": 0,
"subscribesSumm": 0,
"messagesSumm": 0,
"postsSumm": 0,
"streamsSumm": 0,
"totalSumm": 0,
"lastActivity": "2025-01-01T00:00:00+00:00",
"recommendations": 0,
"subscribes": [
{
"id": 123,
"userId": 123,
"subscriberId": 123,
"date": "2025-01-01T00:00:00+00:00",
"duration": 7,
"startDate": "2025-01-01T00:00:00+00:00",
"expireDate": "2025-01-01T00:00:00+00:00",
"cancelDate": null,
"price": 0,
"regularPrice": 4.99,
"discount": 0,
"earningId": 0,
"action": "subscribe",
"type": "trial",
"offerStart": "2025-01-01T00:00:00+00:00",
"offerEnd": "2025-01-01T00:00:00+00:00",
"isCurrent": true
}
],
"hasActivePaidSubscriptions": false
},
"canTrialSend": false,
"isBlocked": false,
"promoOffers": [
{
"id": 123,
"subscribeDays": 7,
"createdAt": "2025-01-01T00:00:00+00:00",
"expiredAt": "2025-01-01T00:00:00+00:00",
"finishedAt": "2025-01-01T00:00:00+00:00",
"subscriberId": "123",
"userId": "123"
}
]
}
],
"hasMore": false
},
"_pagination": {
"next_page": null
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999840,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 10000000,
"limit_day": 50000,
"remaining_minute": 9999999,
"remaining_day": 49998
}
}
}