Engagement / Messages
Mass Messages Chart
Get engagement chart metrics for mass messages: sent count and purchase amount over time.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
account*string
The Account ID
Query Parameters
startDate?string
Start of the chart window in Y-m-d H:i:s format.
endDate?string
End of the chart window in Y-m-d H:i:s format. Must be after startDate.
withTotal?boolean
Include total and delta aggregates in the response. Defaults to true.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/engagement/messages/mass-messages/chart?startDate=2026-01-07+00%3A00%3A00&endDate=2026-02-06+22%3A19%3A59&withTotal=true"{
"data": {
"group_messages": {
"chart": [
{
"date": "2026-01-07T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-08T00:00:00+00:00",
"count": 5
},
{
"date": "2026-01-09T00:00:00+00:00",
"count": 10
},
{
"date": "2026-01-10T00:00:00+00:00",
"count": 7
},
{
"date": "2026-01-11T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-12T00:00:00+00:00",
"count": 11
},
{
"date": "2026-01-13T00:00:00+00:00",
"count": 6
},
{
"date": "2026-01-14T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-15T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-16T00:00:00+00:00",
"count": 12
},
{
"date": "2026-01-17T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-18T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-19T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-20T00:00:00+00:00",
"count": 5
},
{
"date": "2026-01-21T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-22T00:00:00+00:00",
"count": 11
},
{
"date": "2026-01-23T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-24T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-25T00:00:00+00:00",
"count": 8
},
{
"date": "2026-01-26T00:00:00+00:00",
"count": 10
},
{
"date": "2026-01-27T00:00:00+00:00",
"count": 5
},
{
"date": "2026-01-28T00:00:00+00:00",
"count": 7
},
{
"date": "2026-01-29T00:00:00+00:00",
"count": 6
},
{
"date": "2026-01-30T00:00:00+00:00",
"count": 9
},
{
"date": "2026-01-31T00:00:00+00:00",
"count": 4
},
{
"date": "2026-02-01T00:00:00+00:00",
"count": 6
},
{
"date": "2026-02-02T00:00:00+00:00",
"count": 12
},
{
"date": "2026-02-03T00:00:00+00:00",
"count": 6
},
{
"date": "2026-02-04T00:00:00+00:00",
"count": 10
},
{
"date": "2026-02-05T00:00:00+00:00",
"count": 13
},
{
"date": "2026-02-06T00:00:00+00:00",
"count": 8
}
],
"total": 256,
"delta": 32.6
},
"group_messages_purchases": {
"chart": [
{
"date": "2026-01-07T00:00:00+00:00",
"count": 846.54
},
{
"date": "2026-01-08T00:00:00+00:00",
"count": 549.11
},
{
"date": "2026-01-09T00:00:00+00:00",
"count": 1665.94
},
{
"date": "2026-01-10T00:00:00+00:00",
"count": 1063.36
},
{
"date": "2026-01-11T00:00:00+00:00",
"count": 1368.39
},
{
"date": "2026-01-12T00:00:00+00:00",
"count": 1207.98
},
{
"date": "2026-01-13T00:00:00+00:00",
"count": 1067.6
},
{
"date": "2026-01-14T00:00:00+00:00",
"count": 1009.73
},
{
"date": "2026-01-15T00:00:00+00:00",
"count": 548.28
},
{
"date": "2026-01-16T00:00:00+00:00",
"count": 1225.95
},
{
"date": "2026-01-17T00:00:00+00:00",
"count": 729.63
},
{
"date": "2026-01-18T00:00:00+00:00",
"count": 1031.37
},
{
"date": "2026-01-19T00:00:00+00:00",
"count": 1030.77
},
{
"date": "2026-01-20T00:00:00+00:00",
"count": 664.54
},
{
"date": "2026-01-21T00:00:00+00:00",
"count": 989.29
},
{
"date": "2026-01-22T00:00:00+00:00",
"count": 1208.15
},
{
"date": "2026-01-23T00:00:00+00:00",
"count": 981.15
},
{
"date": "2026-01-24T00:00:00+00:00",
"count": 807.61
},
{
"date": "2026-01-25T00:00:00+00:00",
"count": 1343.55
},
{
"date": "2026-01-26T00:00:00+00:00",
"count": 1040.85
},
{
"date": "2026-01-27T00:00:00+00:00",
"count": 468.98
},
{
"date": "2026-01-28T00:00:00+00:00",
"count": 1515.54
},
{
"date": "2026-01-29T00:00:00+00:00",
"count": 1497.24
},
{
"date": "2026-01-30T00:00:00+00:00",
"count": 1331.33
},
{
"date": "2026-01-31T00:00:00+00:00",
"count": 938.93
},
{
"date": "2026-02-01T00:00:00+00:00",
"count": 372.78
},
{
"date": "2026-02-02T00:00:00+00:00",
"count": 780.88
},
{
"date": "2026-02-03T00:00:00+00:00",
"count": 521.2
},
{
"date": "2026-02-04T00:00:00+00:00",
"count": 1409.73
},
{
"date": "2026-02-05T00:00:00+00:00",
"count": 1330.83
},
{
"date": "2026-02-06T00:00:00+00:00",
"count": 1504.63
}
],
"total": 32131,
"delta": -1.7
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 11270561,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}