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": 123,
        "trialLinkName": "My Trial Link",
        "url": "https://onlyfans.com/username/trial/code",
        "subscribeDays": 123,
        "subscribeCounts": 123,
        "claimCounts": 123,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "expiredAt": "2025-01-05T00:00:00+00:00",
        "isFinished": false
      }
    ],
    "hasMore": false
  },
  "_pagination": {
    "next_page": null
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999841,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49999
    }
  }
}

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

The response is of type object.