Mass Messages
Mass Message Statistics
Returns mass message stats — sent count, viewed count, and other metrics per mass message. Cursor-based pagination by end_date. Requires permission api_mass_messages_list.
https://public-api.buffmetrics.comGET/v1/{account_id}/mass-messages
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
limitintegerNumber of items. Default 10. Min 1, max 100.
start_datestringEarliest mass message date (UTC). Default 2 years ago. Format
YYYY-MM-DD HH:MM:SSor RFC 3339.end_datestringLatest mass message date (UTC). Default end of today. For pagination, pass the last item's
date.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/mass-messages?limit=20&start_date=sample_start_date&end_date=sample_end_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":[
0:{
"date":"2026-05-14T18:05:07+00:00"
"text":"message text..."
"sentCount":1500
"viewedCount":800
"mediaCount":1
"price":0
"isFree":true
}
]
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}