FMFansMetric API

Chat

Chat Overview

Returns the 11-stat chat performance headline for an account over a date window — the current value, the previous window's value, and the percent change for each stat. Pair with Chat Chart to draw a trend line for any single stat. Requires permission api_chat_read_overview.

https://public-api.buffmetrics.com
GET/v1/{account_id}/chat/overview
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Query Parameters

  • fromstring

    Window start (UTC). Default 30 days ago. Accepts ISO 8601 (2026-07-08T00:00:00Z) or relative shorthand (-30days, -24h).

  • tostring

    Window end (UTC). Default now. Must be after from.

  • revenue_typestring

    net (default) or gross. Applies to tips, messages, chatearnings, averagetip, averagemessage. Count stats ignore this. monthlychatearnings and chatafv are always net.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/chat/overview?from=sample_from&to=sample_to&revenue_type=sample_revenue_type" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"metrics":[
0:{
"stat":"outgoingmessages"
"statHuman":"Outgoing Messages"
"description":"The number of outgoing messages sent by your chatters."
"current":48210
"previous":41805
"change":0.1532
"symbol":""
"valueIsInteger":true
"symbolFirst":true
"positiveIsGood":true
}
1:{
"stat":"chatearnings"
"statHuman":"Chat Earnings"
"description":"Earnings from tips and PPV message unlocks for the window."
"current":82441.28
"previous":74991.1
"change":0.0993
"symbol":"$"
"valueIsInteger":false
"symbolFirst":true
"positiveIsGood":true
}
2:{
"stat":"tips"
"statHuman":"Tips ($)"
"description":"Earnings from tips for the window."
"current":21440.16
"previous":19052.32
"change":0.1253
"symbol":"$"
"valueIsInteger":false
"symbolFirst":true
"positiveIsGood":true
}
]
"from":"2026-07-11T00:00:00Z"
"to":"2026-08-10T00:00:00Z"
"revenueType":"net"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

List All Earnings

Next

Chat Chart