Earnings
Earnings Overview
Returns aggregated earnings and activity stats for a date window — top-line totals plus per-section breakdowns (posts, streams, visitors, mass messages) with monthly chart data. The "dashboard" view; for the per-transaction feed use List All Earnings. Requires permission api_earnings_read_overview.
https://public-api.buffmetrics.comGET/v1/{account_id}/earnings/overview
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. Format
YYYY-MM-DD HH:MM:SSor ISO 8601.end_datestringWindow end. Default end of today, UTC. Same format as
start_date.bystringNarrow the response to a single section. Values:
earnings,posts,streams,visitors,massMessages,story,promo. Forwarded upstream as-is.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/earnings/overview?start_date=sample_start_date&end_date=sample_end_date&by=sample_by" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"earning":{
"total":1340918.6
"gross":1675118.6
"delta":100
}
"posts":{
"hasStatistic":true
"count":{
"total":5354
"delta":100
}
"views":{
"total":9821330
"delta":100
}
"earnings":{
"total":244018.4
"gross":305023
"delta":100
}
"chartData":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":12410.5
}
]
}
"streams":{
"hasStatistic":false
"count":{
"total":"0m"
"delta":0
}
"views":{
"total":0
"delta":0
}
"earnings":{
"total":0
"gross":0
"delta":0
}
"chartData":[]
}
"visitors":{
"hasStatistic":true
"count":{
"total":2581195
"delta":100
}
"visitors":{
"total":2581195
"delta":100
}
"subscriptions":{
"new":{
"total":3210
"delta":100
}
"renew":{
"total":8154
"delta":33
}
}
"chartData":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":19922
}
]
}
"massMessages":{
"hasStatistic":true
"count":{
"total":412
"delta":100
}
"views":{
"total":198455
"delta":100
}
"earnings":{
"total":78211.45
"gross":97764.31
"delta":100
}
"chartData":[]
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}