Free trial links
List Free Trial Link Spenders
Only available if we already scraped subscribers and calculated revenue per fan
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
trial_link_idstring
The ID of the free trial link to get spenders for
Query Parameters
limit?integer
The number of spenders to return per page. Default 50.
offset?integer
The offset used for pagination. Default 0.
minSpend?number
Minimal spend of a fan. Default 1. Must be at least 1.
Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/trial-links/string/spenders?limit=50&offset=0&minSpend=1""{\n \"data\": [\n {\n \"onlyfans_id\": \"100000001\",\n \"username\": \"user_001\",\n \"revenue\": {\n \"total\": 26.8,\n \"messages\": 20.2,\n \"tips\": 4,\n \"posts\": 0,\n \"streams\": 0,\n \"subscriptions\": 2.6\n },\n \"onlyfans_user_data\": {\n \"id\": 100000001,\n \"name\": \"John Smith\",\n \"view\": \"x\",\n \"avatar\": null,\n \"header\": null,\n \"notice\": \"\",\n \"canEarn\": false,\n \"tipsMax\": 200,\n \"tipsMin\": 5,\n \"hideChat\": false,\n \"lastSeen\": null,\n \"username\": \"user_001\",\n \"canReport\": true,\n \"hasStream\": false,\n \"isBlocked\": false,\n \"hasStories\": false,\n \"headerSize\": null,\n \"isVerified\": false,\n \"canRestrict\": true,\n \"displayName\": \"\",\n \"isPerformer\": false,\n \"listsStates\": [\n {\n \"id\": \"fans\",\n \"name\": \"Fans\",\n \"type\": \"fans\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": null\n },\n {\n \"id\": \"following\",\n \"name\": \"Following\",\n \"type\": \"following\",\n \"hasUser\": true,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"ALREADY_EXISTS\"\n },\n {\n \"id\": \"muted\",\n \"name\": \"Muted\",\n \"type\": \"muted\",\n \"hasUser\": false,\n \"canAddUser\": true,\n \"cannotAddUserReason\": null\n },\n {\n \"id\": \"recent\",\n \"name\": \"Recent (last 24 hours)\",\n \"type\": \"recent\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"SYSTEM_LIST\"\n },\n {\n \"id\": \"friends\",\n \"name\": \"Friends\",\n \"type\": \"friends\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"USER_NOT_PERFORMER\"\n },\n {\n \"id\": \"rebill_off\",\n \"name\": \"Renew Off\",\n \"type\": \"rebill_off\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": null\n },\n {\n \"id\": \"rebill_on\",\n \"name\": \"Renew On\",\n \"type\": \"rebill_on\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": null\n },\n {\n \"id\": \"tagged\",\n \"name\": \"Tagged\",\n \"type\": \"tagged\",\n \"hasUser\": false,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"SYSTEM_LIST\"\n },\n {\n \"id\": 1181087376,\n \"name\": \"Low Spenders-57U\",\n \"type\": \"custom\",\n \"hasUser\": true,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"ALREADY_EXISTS\"\n },\n {\n \"id\": 1089525746,\n \"name\": \"today\",\n \"type\": \"custom\",\n \"hasUser\": true,\n \"canAddUser\": false,\n \"cannotAddUserReason\": \"ALREADY_EXISTS\"\n }\n ],\n \"promoOffers\": [\n {\n \"id\": 509995094,\n \"userId\": \"169224851\",\n \"createdAt\": \"2025-08-06T13:36:56+00:00\",\n \"expiredAt\": \"2025-08-13T13:36:56+00:00\",\n \"finishedAt\": \"2025-08-06T15:27:38+00:00\",\n \"subscriberId\": \"100000001\",\n \"subscribeDays\": 7\n }\n ],\n \"tipsEnabled\": false,\n \"avatarThumbs\": null,\n \"canLookStory\": true,\n \"canTrialSend\": true,\n \"headerThumbs\": null,\n \"isRestricted\": false,\n \"subscribedBy\": true,\n \"subscribedOn\": null,\n \"canPayInternal\": true,\n \"canUnsubscribe\": true,\n \"subscribePrice\": 0,\n \"canCommentStory\": true,\n \"isRealPerformer\": false,\n \"tipsMinInternal\": 1,\n \"tipsTextEnabled\": true,\n \"canAddSubscriber\": false,\n \"subscribedByData\": {\n \"price\": 0,\n \"status\": null,\n \"isMuted\": false,\n \"duration\": \"1 month\",\n \"newPrice\": 0,\n \"expiredAt\": \"2035-07-06T00:40:59+00:00\",\n \"renewedAt\": \"2035-07-06T00:00:00+00:00\",\n \"subscribes\": [\n {\n \"id\": 13796851781,\n \"date\": \"2025-07-06T00:40:59+00:00\",\n \"type\": \"auto\",\n \"price\": 0,\n \"action\": \"subscribe\",\n \"userId\": 100000001,\n \"discount\": 0,\n \"duration\": 3652,\n \"offerEnd\": null,\n \"earningId\": 0,\n \"isCurrent\": true,\n \"startDate\": \"2025-07-06T00:40:59+00:00\",\n \"cancelDate\": null,\n \"expireDate\": \"2035-07-06T00:40:59+00:00\",\n \"offerStart\": null,\n \"regularPrice\": 0,\n \"subscriberId\": 169224851\n }\n ],\n \"subscribeAt\": \"2025-07-06T00:40:59+00:00\",\n \"regularPrice\": 0,\n \"discountPeriod\": 1,\n \"subscribePrice\": 0,\n \"discountPercent\": 0,\n \"showPostsInFeed\": true,\n \"discountStartedAt\": null,\n \"unsubscribeReason\": \"No reason given\",\n \"discountFinishedAt\": null,\n \"hasActivePaidSubscriptions\": false\n },\n \"subscribedOnData\": {\n \"price\": 3.25,\n \"status\": null,\n \"isMuted\": false,\n \"duration\": \"1 month\",\n \"newPrice\": 0,\n \"tipsSumm\": 4,\n \"expiredAt\": \"2025-08-13T15:27:36+00:00\",\n \"postsSumm\": 0,\n \"renewedAt\": null,\n \"totalSumm\": 26.8,\n \"subscribes\": [],\n \"streamsSumm\": 0,\n \"subscribeAt\": \"2025-07-06T00:40:58+00:00\",\n \"lastActivity\": \"2025-08-06T19:24:58+00:00\",\n \"messagesSumm\": 20.2,\n \"regularPrice\": 12.99,\n \"discountPeriod\": 1,\n \"subscribePrice\": 11.04,\n \"subscribesSumm\": 2.6,\n \"discountPercent\": 15,\n \"recommendations\": 0,\n \"discountStartedAt\": \"2025-08-05T00:41:04+00:00\",\n \"unsubscribeReason\": \"No reason given\",\n \"discountFinishedAt\": \"2025-09-05T00:41:04+00:00\",\n \"hasActivePaidSubscriptions\": false\n },\n \"hasNotViewedStory\": false,\n \"hasScheduledStream\": false,\n \"subscribedByExpire\": false,\n \"isPendingAutoprolong\": false,\n \"subscribedOnDuration\": \"1 month\",\n \"canReceiveChatMessage\": true,\n \"currentSubscribePrice\": 0,\n \"subscribedByExpireDate\": \"2035-07-06T00:40:59+00:00\",\n \"subscribedIsExpiredNow\": false,\n \"subscribedOnExpiredNow\": true,\n \"subscribedByAutoprolong\": true\n }\n },\n {\n \"onlyfans_id\": \"100000002\",\n \"username\": \"user_002\",\n \"revenue\": {\n \"total\": 109.88,\n \"messages\": 104.68,\n \"tips\": 0,\n \"posts\": 0,\n \"streams\": 0,\n \"subscriptions\": 5.2\n },\n \"onlyfans_user_data\": {\n // ...\n }\n },\n {\n \"onlyfans_id\": \"100000003\",\n \"username\": \"user_003\",\n \"revenue\": {\n \"total\": 32.96,\n \"messages\": 30.36,\n \"tips\": 0,\n \"posts\": 0,\n \"streams\": 0,\n \"subscriptions\": 2.6\n },\n \"onlyfans_user_data\": {\n // ...\n }\n }\n ],\n \"_meta\": {\n \"_credits\": {\n \"used\": 1,\n \"balance\": 224802,\n \"note\": \"Always\"\n },\n \"_cache\": {\n \"is_cached\": false,\n \"note\": \"Cache disabled for this endpoint\"\n },\n \"_rate_limits\": {\n \"limit_minute\": 1000,\n \"limit_day\": 50000,\n \"remaining_minute\": 994,\n \"remaining_day\": 49929\n }\n }\n}\n"