Referrals
Get Referral Payouts Chart
Returns the referral-commission timeseries that backs the OnlyFans **Statements → Referrals** page — one $ series (chartAmount), one payout-count series (chartCount), net + gross totals, and OF's percent-change delta vs the previous equal-length window. Bucket granularity (daily vs monthly) is chosen by OnlyFans based on window length. Requires permission api_referrals_read_chart.
https://public-api.buffmetrics.comGET/v1/{account_id}/referrals/payouts/chart
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
start_datestringWindow start. Default 2 years ago, UTC.
YYYY-MM-DD HH:MM:SSor ISO 8601 (theTseparator is normalized to a space).end_datestringWindow end. Default end of today, UTC. Same format as
start_date.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/referrals/payouts/chart?start_date=sample_start_date&end_date=sample_end_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"chartAmount":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":0
}
1:{
"date":"2025-10-01T00:00:00+00:00"
"count":482.31
}
]
"chartCount":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":0
}
1:{
"date":"2025-10-01T00:00:00+00:00"
"count":3
}
]
"total":4458.86
"gross":5573.58
"delta":100
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}