Reach
List Promotions
Returns the history of subscription promotions (discounted-price offers + free-trial bundles) the creator has run. Filterable by createdAt window. For aggregate promo earnings + a monthly chart, use Earnings Overview with by=promo. Requires permission api_reach_list_promotions.
https://public-api.fansmetric.comGET/v1/{account_id}/reach/promotions
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 10. Min 1, max 100.
offsetintegerRows to skip.
start_datestringLower bound on
createdAt. Default 2 years ago, UTC.end_datestringUpper bound on
createdAt. Default end of today, UTC.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/reach/promotions?limit=20&offset=0&start_date=sample_start_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"hasMore":true
"items":[
0:{
"id":44934374
"message":"Join me in my sexcapades"
"rawMessage":"Join me in my sexcapades"
"hasRelatedPromo":false
"price":4
"type":"all"
"canClaim":false
"claimsCount":3
"subscribeCounts":null
"subscribeDays":0
"createdAt":"2025-02-21T05:53:48+00:00"
"finishedAt":"2025-02-28T05:53:48+00:00"
"isFinished":true
}
]
}
"_pagination":{
"next_page":"/v1/21689165/reach/promotions?limit=10&offset=10"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}