Trial Links
Get Trial Link Stats
Returns cumulative totals plus daily and monthly time-series for a single trial link. Requires permission api_trial_links_read.
https://public-api.buffmetrics.comGET/v1/{account_id}/trial-links/{link_id}/stats
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
date_startstringWindow start (UTC). Absent → unbounded.
date_endstringWindow end (UTC). Absent → unbounded.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/trial-links/sample_link_id/stats?date_start=sample_date_start&date_end=sample_date_end" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"summary":{
"clicks_total":null
"subs_total":45
"revenue_total":"245.50"
"spenders_total":6
"last_scanned_at":"2026-08-05T02:11:30Z"
}
"daily_metrics":[
0:{
"timestamp":"2026-07-31"
"clicks":null
"subs":3
"revenue":"12.50"
"spenders":1
}
1:{
"timestamp":"2026-08-01"
"clicks":null
"subs":2
"revenue":"0.00"
"spenders":0
}
2:{
"timestamp":"2026-08-02"
"clicks":null
"subs":4
"revenue":"38.20"
"spenders":2
}
]
"monthly_metrics":[
0:{
"timestamp":"2026-07-01"
"clicks":null
"subs":30
"revenue":"180.30"
"spenders":4
}
1:{
"timestamp":"2026-08-01"
"clicks":null
"subs":15
"revenue":"65.20"
"spenders":2
}
]
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}