Trial Links

List Trial Links

Returns the creator's trial links. Pure passthrough from OnlyFans — same payload OF's webapp renders on its Trials tab. Requires permission api_trial_links_list.

https://public-api.buffmetrics.com
GET/v1/{account_id}/trial-links
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Query Parameters

  • limitinteger

    Page size. Default 10. Min 1, max 200 (values above 200 are clamped).

  • offsetinteger

    Rows to skip. Default 0.

  • fieldstring

    Sort column. One of create_date (default — note the missing d, this matches OF), expire_date, claims_count, clicks_count, subscribe_counts, subscribe_days, shared.

  • sortstring

    desc (default) or asc.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/trial-links?limit=20&offset=0&field=sample_field" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":100000020
"trialLinkName":"1 MONTH FREE TRIAL"
"url":"https://onlyfans.com/creator_XXXXX/trial/XXXXXXXXXXXXXXXXXXXXXXXXX"
"subscribeDays":30
"subscribeCounts":0
"claimCounts":37
"clicksCounts":412
"isFinished":false
"createdAt":"2026-04-05T17:02:51Z"
"expiredAt":null
"user":{
"id":100000001
"username":"creator_XXXXX"
}
"sharedWith":[]
}
]
"hasMore":false
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}