Trial Links

Get Trial Link

Returns a single trial link with FansMetric revenue enrichment. DB-backed — this endpoint still merges OF state with fm* attribution fields that were dropped from [List Trial Links](/api-reference/trial-links/list) when the list flipped to pure OF passthrough. Requires permission api_trial_links_read.

https://public-api.buffmetrics.com
GET/v1/{account_id}/trial-links/{link_id}
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.

  • link_id*integer

    Trial link platform ID (OF trial ID).

Query Parameters

  • start_datestring

    Start of date range for FansMetric revenue enrichment. Supports YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, RFC 3339, and relative formats (UTC).

  • end_datestring

    End of date range. Same formats as start_date.

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
"allTimeClaimCounts":37
"isFinished":false
"createdAt":"2026-04-05T17:02:51Z"
"fmRevenue":"245.50"
"fmTags":[
0:{
"id":1
"name":"Reddit"
"color":"#FF5733"
"created_at":"2026-01-12T09:14:22Z"
}
1:{
"id":2
"name":"Twitter"
"color":"#1DA1F2"
"created_at":"2026-01-12T09:15:01Z"
}
]
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}