Skip to main content
GET
/
api
/
{account}
/
trial-links
List Trial Links
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/trial-links \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "list": [
      {
        "id": 10418768,
        "trialLinkName": "TEST",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 30,
        "subscribeCounts": 0,
        "claimCounts": 69,
        "expiredAt": null,
        "createdAt": "2025-07-15T15:43:43+00:00",
        "isFinished": false,
        "revenue": {
          "total": 1860.8,
          "revenuePerSubscriber": 26.968115942029,
          "calculatedAt": "2025-07-29T16:53:35.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10418768/subscribers"
          }
        }
      },
      {
        "id": 10386507,
        "trialLinkName": "Free",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 7,
        "subscribeCounts": 1,
        "claimCounts": 1,
        "expiredAt": "2025-07-11T10:00:00+00:00",
        "createdAt": "2025-07-04T10:00:00+00:00",
        "isFinished": true,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "calculatedAt": "2025-07-29T16:53:37.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10386507/subscribers"
          }
        }
      },
      {
        "id": 10320079,
        "trialLinkName": "SFS C",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 14,
        "subscribeCounts": 0,
        "claimCounts": 459,
        "expiredAt": null,
        "createdAt": "2025-06-11T19:40:26+00:00",
        "isFinished": false,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "calculatedAt": null,
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10320079/subscribers"
          }
        }
      },
      {
        "id": 10257001,
        "trialLinkName": "OnlyFansAPI dev testing",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 360,
        "subscribeCounts": 10,
        "claimCounts": 1,
        "expiredAt": null,
        "createdAt": "2025-05-21T20:17:49+00:00",
        "isFinished": false,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "calculatedAt": "2025-07-29T16:53:39.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10257001/subscribers"
          }
        }
      },
      {
        "id": 10188882,
        "trialLinkName": "FTL",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 360,
        "subscribeCounts": 1,
        "claimCounts": 1,
        "expiredAt": "2025-05-05T14:03:39+00:00",
        "createdAt": "2025-04-30T14:03:39+00:00",
        "isFinished": true,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "calculatedAt": "2025-07-29T16:53:41.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10188882/subscribers"
          }
        }
      },
      {
        "id": 10131181,
        "trialLinkName": "OnlyFansAPI / April",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 3,
        "subscribeCounts": 0,
        "claimCounts": 48,
        "expiredAt": null,
        "createdAt": "2025-04-12T05:37:48+00:00",
        "isFinished": false,
        "revenue": {
          "total": 82.24,
          "revenuePerSubscriber": 1.7133333333333,
          "calculatedAt": "2025-07-29T16:53:45.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10131181/subscribers"
          }
        }
      },
      {
        "id": 10131179,
        "trialLinkName": "OnlyFansAPI / April #2",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 7,
        "subscribeCounts": 10,
        "claimCounts": 0,
        "expiredAt": "2025-04-12T05:37:05+00:00",
        "createdAt": "2025-04-12T05:36:57+00:00",
        "isFinished": true,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "calculatedAt": "2025-07-29T16:53:46.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/10131179/subscribers"
          }
        }
      },
      {
        "id": 9717919,
        "trialLinkName": "MODEL_NAME SFS",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 7,
        "subscribeCounts": 0,
        "claimCounts": 19,
        "expiredAt": "2024-12-17T18:04:15+00:00",
        "createdAt": "2024-12-13T18:04:15+00:00",
        "isFinished": true,
        "revenue": {
          "total": 593.45,
          "revenuePerSubscriber": 31.234210526316,
          "calculatedAt": "2025-07-29T16:53:50.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/9717919/subscribers"
          }
        }
      },
      {
        "id": 9706489,
        "trialLinkName": "MODEL_NAME SFS",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 7,
        "subscribeCounts": 0,
        "claimCounts": 67,
        "expiredAt": "2024-12-14T17:18:12+00:00",
        "createdAt": "2024-12-10T17:18:12+00:00",
        "isFinished": true,
        "revenue": {
          "total": 885.4,
          "revenuePerSubscriber": 13.214925373134,
          "calculatedAt": "2025-07-29T16:53:15.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/9706489/subscribers"
          }
        }
      },
      {
        "id": 9695029,
        "trialLinkName": "MODEL_NAME SFS",
        "url": "https://onlyfans.com/ONLYFANS_USERNAME/trial/ONLYFANS_FREE_TRIAL_TOKEN",
        "subscribeDays": 7,
        "subscribeCounts": 0,
        "claimCounts": 30,
        "expiredAt": "2024-12-11T19:04:22+00:00",
        "createdAt": "2024-12-07T19:04:22+00:00",
        "isFinished": true,
        "revenue": {
          "total": 612.3,
          "revenuePerSubscriber": 20.41,
          "calculatedAt": "2025-07-29T16:53:54.000000Z",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links/9695029/subscribers"
          }
        }
      }
    ],
    "hasMore": true
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXXXXXXXX/trial-links?offset=10&limit=10"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999944,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 998,
      "remaining_day": 49978
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
limit
integer
required

The number of trial links to return. Default 10

Example:

10

​
offset
integer
required

The offset used for pagination. Default 0

Example:

0

​
sort
enum<string> | null

Sort the results. Default desc

Available options:
desc,
asc
Example:

"desc"

​
field
enum<string> | null

Sort the results by a field. Default create_date

Available options:
create_date,
expire_date,
subscribe_counts,
subscribe_days,
claims_count
Example:

"create_date"

Response

200 - application/json

Success

​
data
object
​
_pagination
object
​
_meta
object