The Only API docs
Misc

Get top subscribers stats

Retrieves top subscribers over a date range (statistics context). OnlyFans only — Fansly accounts are rejected on /api2/v2/.

GET
/api2/v2/subscriptions/subscribers/top

Retrieves top subscribers over a date range (statistics context). 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 date range

endDate*string

End of date range

by?string

Metric to rank by

offset?string

Pagination offset

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/subscriptions/subscribers/top?startDate=string&endDate=string" \  -H "user-id: 509955039"
{  "success": true,  "status_code": 0,  "data": {    "users": [      {        "view": "string",        "avatar": null,        "avatarThumbs": null,        "header": null,        "headerSize": null,        "headerThumbs": null,        "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,        "displayName": "string",        "notice": "string",        "isActive": true,        "isRestricted": true,        "canRestrict": true,        "subscribedBy": true,        "subscribedByExpire": true,        "subscribedByExpireDate": "string",        "subscribedByAutoprolong": true,        "subscribedIsExpiredNow": true,        "currentSubscribePrice": 0,        "subscribedOn": null,        "subscribedOnExpire": true,        "subscribedOnExpiredNow": true,        "subscribedOnDuration": "string",        "listsStates": [],        "canReport": true,        "canReceiveChatMessage": true,        "hideChat": true,        "lastSeen": "string",        "isPerformer": true,        "isRealPerformer": true,        "subscribedByData": {},        "subscribedOnData": {},        "canTrialSend": true,        "isBlocked": true,        "canUnsubscribe": true,        "isPendingAutoprolong": true      }    ],    "hasMore": true  }}

Get latest subscribers GET

Returns the latest subscribers within a date range, grouped by the given field. The dynamic path segment is actually the querystring. OnlyFans only — Fansly accounts are…

Search localization texts POST

Searches localization strings by code and languages. Part of the i18n text system (texts.onlyfans.com). OnlyFans only — Fansly accounts are rejected on /api2/v2/.