Free trial links
List Free Trial Links
List all free trial links for the account, including the details and statistics
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
}
}
}