We just released our native n8n integration!» Try now
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,
        "clicksCounts": 182,
        "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
    }
  }
}