Promotions
List Promotions & Trials
Returns a single chronological feed that interleaves promotions and free-trial-link items — the same view that powers the OnlyFans "Promotions & Trials" tab. Each item is either a promo or a trial object — never both. Requires permission api_promotions_trials_list.
https://public-api.buffmetrics.comGET/v1/{account_id}/promotions-trials
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.
Query Parameters
limitintegerPage size. Default 100. Min 1, max 200.
offsetintegerRows to skip. Default 0.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/promotions-trials?limit=20&offset=0" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"items":[
0:{
"promo":{
"id":123
"message":"Half off your first month!"
"rawMessage":"Half off your first month!"
"hasRelatedPromo":false
"price":0
"type":"new"
"canClaim":true
"claimsCount":12
"subscribeCounts":100
"subscribeDays":30
"createdAt":"2026-06-01T12:00:00+00:00"
"finishedAt":"2026-06-08T12:00:00+00:00"
"isFinished":false
}
}
1:{
"trial":{
"id":4567
"url":"https://onlyfans.com/action/trial/4567/..."
"trialLinkName":"Reddit June"
"subscribeDays":7
"subscribeCounts":50
"claimCounts":18
"createdAt":"2026-05-20T08:00:00+00:00"
"expiredAt":"2026-07-20T08:00:00+00:00"
"isFinished":false
}
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/12345678/promotions-trials?limit=100&offset=100"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}