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
Query parameters
limitinteger required
The number of trial links to return. Default 10
Example:10
The number of trial links to return. Default 10
offsetinteger required
The offset used for pagination. Default 0
The offset used for pagination. Default 0
sort'desc' | 'asc' nullable
Sort the results. Default desc
Example:desc
Sort the results. Default desc
field'create_date' | 'expire_date' | 'subscribe_counts' | 'subscribe_days' | 'claims_count' nullable
Sort the results by a field. Default create_date
Example:create_date
Sort the results by a field. Default create_date
synchronousboolean nullable
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
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
Success
Example response
{
"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,
"tags": [
"Instagram",
"Twitter"
],
"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
}
}
}