Trial Links
Get Trial Link
Returns a single trial link. DB-backed, so the shape matches an item from the FansMetric-backed list — not the leaner OnlyFans payload the bare list route relays. Requires permission api_trial_links_read.
https://public-api.buffmetrics.comGET/v1/{account_id}/trial-links/{link_id}
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
link_id*integerTrial link ID.
Query Parameters
start_datestringWindow start for revenue and claim counts. Absent → all-time.
end_datestringWindow end. Absent → all-time.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/trial-links/sample_link_id?start_date=sample_start_date&end_date=sample_end_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"id":100000020
"trialLinkName":"1 MONTH FREE TRIAL"
"url":"https://onlyfans.com/creator_XXXXX/trial/XXXXXXXXXXXXXXXXXXXXXXXXX"
"subscribeDays":30
"subscribeCounts":0
"claimCounts":37
"allClaimCounts":45
"isFinished":false
"createdAt":"2026-04-05T17:02:51Z"
"expiredAt":null
"customName":"Instagram bio"
"customSourceUrl":"https://instagram.com/creator_XXXXX"
"note":null
"isHidden":false
"isRevenueShared":false
"lastScannedAt":"2026-08-05T02:11:30Z"
"user":{
"username":"creator_XXXXX"
}
"tags":[
0:{
"id":2
"name":"Instagram"
"color":"#E4405F"
"created_at":"2026-02-04T16:02:10Z"
}
]
"revenue":{
"total":"245.50"
"spendersCount":6
"revenuePerSubscriber":"6.6351"
"conversionToSpender":"0.16216"
}
"cost":{
"perPromo":"20.00"
"perSub":"0.5405"
"profit":"225.50"
"roi":"1127.5"
}
"links":{
"related":{
"subscribers":"/v1/100000001/trial-links/100000020/subscribers"
}
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}