FMFansMetric API

Subscribers

List Subscribers

Returns the list of subscribers (fans) for an account. Supports filtering by type, online status, recommendations, and sorting. Requires permission api_subscribers_list.

https://public-api.fansmetric.com
GET/v1/{account_id}/subscribers
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Query Parameters

  • limitinteger

    Number per page. Default 10. Min 1, max 100.

  • offsetinteger

    Pagination offset.

  • typestring

    active (default) or expired.

  • sort_bystring

    last_activity, expire_date, subscribe_date, or (for type=expired) is_expired.

  • sort_dirstring

    desc (default) or asc.

  • filter_recommendersstring

    true to show only recommended fans.

  • filter_onlinestring

    true to show only online fans.

  • filter_inactivestring

    true to show only inactive fans. Only applies with type=expired.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/subscribers?limit=20&offset=0&type=all" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":570022381
"name":"Anthony"
"username":"u570022381"
"displayName":""
"avatar":null
"avatarThumbs":null
"header":null
"headerSize":null
"headerThumbs":null
"isActive":true
"isBlocked":false
"isRestricted":false
"isVerified":false
"isPerformer":false
"isRealPerformer":false
"isPendingAutoprolong":false
"lastSeen":"2026-05-28T03:18:56+00:00"
"subscribePrice":0
"currentSubscribePrice":0
"subscribedBy":true
"subscribedByAutoprolong":true
"subscribedByExpire":false
"subscribedByExpireDate":"2036-05-28T03:20:17+00:00"
"subscribedIsExpiredNow":false
"subscribedByData":{
"price":0
"regularPrice":0
"newPrice":0
"subscribePrice":0
"duration":""
"subscribeAt":"2026-05-28T03:20:17+00:00"
"renewedAt":"2036-05-28T00:00:00+00:00"
"expiredAt":"2036-05-28T03:20:17+00:00"
"discountPercent":0
"discountPeriod":1
"discountStartedAt":null
"discountFinishedAt":null
"hasActivePaidSubscriptions":false
"isMuted":false
"showPostsInFeed":true
"status":null
"unsubscribeReason":"No reason given"
"subscribes":[
0:{
"id":14972373744
"action":"subscribe"
"type":"auto"
"userId":570022381
"subscriberId":523213896
"date":"2026-05-28T03:20:17+00:00"
"startDate":"2026-05-28T03:20:17+00:00"
"expireDate":"2036-05-28T03:20:17+00:00"
"cancelDate":null
"duration":3653
"discount":0
"price":0
"regularPrice":0
"earningId":0
"offerStart":null
"offerEnd":null
"isCurrent":true
}
]
}
"subscribedOn":true
"subscribedOnDuration":""
"subscribedOnExpiredNow":false
"subscribedOnData":{
"price":0
"regularPrice":0
"newPrice":0
"subscribePrice":0
"duration":""
"subscribeAt":"2026-05-28T03:20:15+00:00"
"renewedAt":"2036-05-28T00:00:00+00:00"
"expiredAt":"2036-05-28T03:20:15+00:00"
"lastActivity":"2026-05-28T03:20:15+00:00"
"discountPercent":0
"discountPeriod":1
"discountStartedAt":null
"discountFinishedAt":null
"hasActivePaidSubscriptions":false
"isMuted":false
"status":null
"messagesSumm":0
"postsSumm":0
"tipsSumm":0
"subscribesSumm":0
"streamsSumm":0
"totalSumm":0
"recommendations":0
"unsubscribeReason":"No reason given"
"subscribes":[
0:{
"id":14972373749
"action":"subscribe"
"type":"regular"
"userId":523213896
"subscriberId":570022381
"date":"2026-05-28T03:20:15+00:00"
"startDate":"2026-05-28T03:20:15+00:00"
"expireDate":"2036-05-28T03:20:15+00:00"
"cancelDate":null
"duration":3653
"discount":0
"price":0
"regularPrice":0
"earningId":0
"offerStart":null
"offerEnd":null
"isCurrent":true
}
]
}
"listsStates":[
0:{
"id":"fans"
"name":"Fans"
"type":"fans"
"hasUser":true
"canAddUser":false
"cannotAddUserReason":"ALREADY_EXISTS"
}
1:{
"id":"following"
"name":"Following"
"type":"following"
"hasUser":true
"canAddUser":false
"cannotAddUserReason":"ALREADY_EXISTS"
}
2:{
"id":"friends"
"name":"Friends"
"type":"friends"
"hasUser":false
"canAddUser":false
"cannotAddUserReason":"USER_NOT_PERFORMER"
}
3:{
"id":"muted"
"name":"Muted"
"type":"muted"
"hasUser":false
"canAddUser":true
"cannotAddUserReason":null
}
4:{
"id":"recent"
"name":"Recent (last 24 hours)"
"type":"recent"
"hasUser":true
"canAddUser":false
"cannotAddUserReason":"ALREADY_EXISTS"
}
5:{
"id":"tagged"
"name":"Tagged"
"type":"tagged"
"hasUser":false
"canAddUser":false
"cannotAddUserReason":"SYSTEM_LIST"
}
]
"canAddSubscriber":false
"canCommentStory":true
"canLookStory":true
"canPayInternal":true
"canReceiveChatMessage":true
"canReport":true
"canRestrict":true
"canTrialSend":false
"canUnsubscribe":true
"canEarn":false
"hideChat":false
"hasStories":false
"hasStream":false
"hasScheduledStream":false
"hasNotViewedStory":false
"tipsEnabled":false
"tipsMin":5
"tipsMax":200
"tipsMinInternal":1
"tipsTextEnabled":true
"promoOffers":[]
"notice":""
"view":"x"
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/{account_id}/subscribers?limit=10&offset=10&type=active"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":991
"limit_day":50000
"remaining_day":49991
}
}
}

Previous

Unsend Message

Next

Get Fan Details