OnlyFans API
Free trial links

List Free Trial Links

List all free trial links for the account, including the details and statistics

GET
/api/{account}/trial-links
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

accountstring

The Account ID

Query Parameters

limitinteger

The number of trial links to return. Default 10

offsetinteger

The offset used for pagination. Default 0

sort?string | null

Sort the results. Default desc

Value in"desc" | "asc"
field?string | null

Sort the results by a field. Default create_date

Value in"create_date" | "expire_date" | "subscribe_counts" | "subscribe_days" | "claims_count"
synchronous?boolean | null

Wait for the revenue data to finish processing, instead of processing in the background. Will result in longer response times, use with caution. Default false

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/trial-links?limit=10&offset=0&sort=desc&field=create_date&synchronous=false"
{
  "data": {
    "list": [
      {
        "id": 123,
        "trialLinkName": "Trial link name",
        "url": "https://onlyfans.com/username/trial/abc123",
        "subscribeDays": 30,
        "subscribeCounts": 0,
        "claimCounts": 123,
        "expiredAt": null,
        "createdAt": "2025-01-01T01:01:01+00:00",
        "isFinished": false,
        "revenue": {
          "total": 123,
          "revenuePerSubscriber": 12,
          "spendersCount": 16,
          "calculatedAt": "2025-01-01T01:01:01+00:00",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_abc123/trial-links/123/subscribers"
          }
        }
      }
    ],
    "hasMore": true
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_abc123/trial-links?limit=10&offset=10"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 115580,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 997,
      "remaining_day": 49990
    }
  }
}