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.

Response Fields

  • data.list[].idinteger

    OnlyFans user ID for the fan.

  • data.list[].namestring

    Display name. Falls back to u{id} when not set.

  • data.list[].usernamestring

    Login handle. Falls back to u{id} when not set.

  • data.list[].displayNamestring

    User-set display name. Often empty.

  • data.list[].avatarstring|null

    Avatar URL. null when no avatar is set.

  • data.list[].avatarThumbsobject|null

    Avatar thumbnails: c50, c144. null when no avatar.

  • data.list[].headerstring|null

    Header image URL. null when not set.

  • data.list[].headerSizeobject|null

    Header dimensions: width, height. May be null.

  • data.list[].headerThumbsobject|null

    Header thumbnails: w480, w760. null when no header.

  • data.list[].isActiveboolean

    Whether the account is active on OnlyFans.

  • data.list[].isBlockedboolean

    Whether the fan is blocked by this account.

  • data.list[].isRestrictedboolean

    Whether the fan is restricted by this account.

  • data.list[].isVerifiedboolean

    OnlyFans verified flag.

  • data.list[].isPerformerboolean

    Whether the fan is a creator on OnlyFans.

  • data.list[].isRealPerformerboolean

    Whether the fan is a fully verified creator.

  • data.list[].lastSeenstring|null

    RFC 3339 timestamp of the fan's last activity. null when never seen or hidden.

  • data.list[].subscribePricenumber

    Base subscription price (USD).

  • data.list[].currentSubscribePricenumber

    Current effective price after discounts (USD).

  • data.list[].subscribedByboolean

    Whether the connected account is subscribed to this fan.

  • data.list[].subscribedByAutoprolongboolean

    Whether that subscription auto-renews.

  • data.list[].subscribedByExpireboolean

    Whether the connected account's subscription is set to expire.

  • data.list[].subscribedByExpireDatestring|null

    Expiry timestamp for the connected account's subscription.

  • data.list[].subscribedByDataobject

    Detail of the connected account's subscription to this fan: price, regularPrice, subscribeAt, expiredAt, renewedAt, duration, subscribes[], etc.

  • data.list[].subscribedOnboolean

    Whether this fan is subscribed to the connected account.

  • data.list[].subscribedOnDurationstring

    Duration label of the fan's subscription (e.g. 7 months). Empty for brand-new subscriptions.

  • data.list[].subscribedOnExpiredNowboolean

    Whether the fan's subscription has already expired.

  • data.list[].subscribedOnDataobject

    Detail of the fan's subscription to the connected account. Includes spend rollups: messagesSumm, postsSumm, tipsSumm, subscribesSumm, streamsSumm, totalSumm, plus subscribeAt, expiredAt, lastActivity, subscribes[].

  • data.list[].listsStatesarray

    Membership in all visible lists (system + custom). Each entry: id, name, type, hasUser, canAddUser, cannotAddUserReason.

  • data.list[].canReceiveChatMessageboolean

    Whether the connected account can DM this fan.

  • data.list[].canCommentStoryboolean

    Whether the connected account can comment on the fan's stories.

  • data.list[].canLookStoryboolean

    Whether the connected account can view the fan's stories.

  • data.list[].canPayInternalboolean

    Whether internal payments are enabled.

  • data.list[].canReportboolean

    Whether the fan can be reported.

  • data.list[].canRestrictboolean

    Whether the fan can be restricted.

  • data.list[].canTrialSendboolean

    Whether a free trial can be sent to this fan.

  • data.list[].canUnsubscribeboolean

    Whether the connected account can unsubscribe from this fan.

  • data.list[].canEarnboolean

    Whether the connected account can earn from this fan.

  • data.list[].canAddSubscriberboolean

    Whether the fan can be added as a subscriber.

  • data.list[].hideChatboolean

    Whether chat is hidden for this fan.

  • data.list[].hasStoriesboolean

    Whether the fan has active stories.

  • data.list[].hasStreamboolean

    Whether the fan is currently streaming.

  • data.list[].hasScheduledStreamboolean

    Whether the fan has a scheduled stream.

  • data.list[].hasNotViewedStoryboolean

    Whether the fan has unviewed stories.

  • data.list[].isPendingAutoprolongboolean

    Whether an auto-renewal is pending.

  • data.list[].tipsEnabledboolean

    Whether the fan accepts tips.

  • data.list[].tipsMinnumber

    Minimum tip amount.

  • data.list[].tipsMaxnumber

    Maximum tip amount.

  • data.list[].tipsMinInternalnumber

    Minimum internal tip amount.

  • data.list[].tipsTextEnabledboolean

    Whether tip messages are enabled.

  • data.list[].promoOffersarray

    Active promo offers for this fan. Empty [] when none.

  • data.list[].noticestring

    Profile notice text. Empty string when none.

  • data.list[].viewstring

    Internal view marker from OnlyFans.

  • data.hasMoreboolean

    Whether more results are available beyond offset + limit.

  • _pagination.next_pagestring

    Relative URL preserving all supplied query parameters with offset bumped. Omitted on the last page.

  • dataobject | array

    Endpoint-specific payload. See the fields below for this route.

  • _meta._credits.usedinteger

    Credits consumed by this request (currently always 1).

  • _meta._rate_limits.limit_minuteinteger

    Maximum requests per minute for the organization.

  • _meta._rate_limits.remaining_minuteinteger

    Remaining requests in the current minute window.

  • _meta._rate_limits.limit_dayinteger

    Maximum requests per day for the organization.

  • _meta._rate_limits.remaining_dayinteger

    Remaining requests in the current day window.

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

Response

200
{
"data":{
"list":[
0:{
"id":100000003
"name":"Fan XX"
"username":"u100000003"
"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":100000003
"subscriberId":100000001
"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":100000001
"subscriberId":100000003
"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