FMFansMetric API

Mass Messages

Mass Message Chart

Returns a daily timeseries for mass (group) messages over a date window — one series of **sent counts** (group_messages.chart) and one series of **$ purchased** from those messages (group_messages_purchases.chart), each with the window total and the delta vs. the prior equal-length window. Aggregate chart view; for per-message rows use [Mass Message Statistics](/api-reference/mass-messages/list-mass-messages). Requires permission api_mass_messages_read_chart.

https://public-api.fansmetric.com
GET/v1/{account_id}/mass-messages/chart
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

  • start_datestring

    Window start. Default 30 days ago, UTC. YYYY-MM-DD HH:MM:SS or ISO 8601 (the T separator is normalized to a space).

  • end_datestring

    Window end. Default end of today, UTC. Same format as start_date.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/mass-messages/chart?start_date=sample_start_date&end_date=sample_end_date" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"group_messages":{
"chart":[
0:{
"date":"2026-05-09T00:00:00+00:00"
"count":50
}
1:{
"date":"2026-05-10T00:00:00+00:00"
"count":49
}
]
"total":1446
"delta":-41.4
}
"group_messages_purchases":{
"chart":[
0:{
"date":"2026-05-09T00:00:00+00:00"
"count":385.54
}
1:{
"date":"2026-05-10T00:00:00+00:00"
"count":282.56
}
]
"total":9469.9
"delta":-18.1
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Direct Message Statistics

Next

Direct Message Chart