Engagement / Messages
Direct Messages Chart
Get engagement chart metrics for direct 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/direct-messages/chart?startDate=2026-01-07+00%3A00%3A00&endDate=2026-02-06+22%3A19%3A59&withTotal=true"{
"data": {
"direct_messages": {
"chart": [
{
"date": "2026-01-07T00:00:00+00:00",
"count": 436
},
{
"date": "2026-01-08T00:00:00+00:00",
"count": 403
},
{
"date": "2026-01-09T00:00:00+00:00",
"count": 587
},
{
"date": "2026-01-10T00:00:00+00:00",
"count": 543
},
{
"date": "2026-01-11T00:00:00+00:00",
"count": 622
},
{
"date": "2026-01-12T00:00:00+00:00",
"count": 538
},
{
"date": "2026-01-13T00:00:00+00:00",
"count": 326
},
{
"date": "2026-01-14T00:00:00+00:00",
"count": 569
},
{
"date": "2026-01-15T00:00:00+00:00",
"count": 478
},
{
"date": "2026-01-16T00:00:00+00:00",
"count": 506
},
{
"date": "2026-01-17T00:00:00+00:00",
"count": 611
},
{
"date": "2026-01-18T00:00:00+00:00",
"count": 593
},
{
"date": "2026-01-19T00:00:00+00:00",
"count": 875
},
{
"date": "2026-01-20T00:00:00+00:00",
"count": 1178
},
{
"date": "2026-01-21T00:00:00+00:00",
"count": 1331
},
{
"date": "2026-01-22T00:00:00+00:00",
"count": 1277
},
{
"date": "2026-01-23T00:00:00+00:00",
"count": 1153
},
{
"date": "2026-01-24T00:00:00+00:00",
"count": 1255
},
{
"date": "2026-01-25T00:00:00+00:00",
"count": 1179
},
{
"date": "2026-01-26T00:00:00+00:00",
"count": 1147
},
{
"date": "2026-01-27T00:00:00+00:00",
"count": 905
},
{
"date": "2026-01-28T00:00:00+00:00",
"count": 1467
},
{
"date": "2026-01-29T00:00:00+00:00",
"count": 1681
},
{
"date": "2026-01-30T00:00:00+00:00",
"count": 1827
},
{
"date": "2026-01-31T00:00:00+00:00",
"count": 1501
},
{
"date": "2026-02-01T00:00:00+00:00",
"count": 935
},
{
"date": "2026-02-02T00:00:00+00:00",
"count": 922
},
{
"date": "2026-02-03T00:00:00+00:00",
"count": 1059
},
{
"date": "2026-02-04T00:00:00+00:00",
"count": 1124
},
{
"date": "2026-02-05T00:00:00+00:00",
"count": 1111
},
{
"date": "2026-02-06T00:00:00+00:00",
"count": 1155
}
],
"total": 29294,
"delta": 71
},
"direct_messages_purchases": {
"chart": [
{
"date": "2026-01-07T00:00:00+00:00",
"count": 4229.47
},
{
"date": "2026-01-08T00:00:00+00:00",
"count": 3501.2
},
{
"date": "2026-01-09T00:00:00+00:00",
"count": 7119.34
},
{
"date": "2026-01-10T00:00:00+00:00",
"count": 5141.29
},
{
"date": "2026-01-11T00:00:00+00:00",
"count": 8131.15
},
{
"date": "2026-01-12T00:00:00+00:00",
"count": 5387.46
},
{
"date": "2026-01-13T00:00:00+00:00",
"count": 2680.16
},
{
"date": "2026-01-14T00:00:00+00:00",
"count": 3728.25
},
{
"date": "2026-01-15T00:00:00+00:00",
"count": 4577.14
},
{
"date": "2026-01-16T00:00:00+00:00",
"count": 4369.77
},
{
"date": "2026-01-17T00:00:00+00:00",
"count": 7509.09
},
{
"date": "2026-01-18T00:00:00+00:00",
"count": 3741.5
},
{
"date": "2026-01-19T00:00:00+00:00",
"count": 3089.89
},
{
"date": "2026-01-20T00:00:00+00:00",
"count": 5318.68
},
{
"date": "2026-01-21T00:00:00+00:00",
"count": 6722.56
},
{
"date": "2026-01-22T00:00:00+00:00",
"count": 4585.53
},
{
"date": "2026-01-23T00:00:00+00:00",
"count": 8163.06
},
{
"date": "2026-01-24T00:00:00+00:00",
"count": 4872.21
},
{
"date": "2026-01-25T00:00:00+00:00",
"count": 5804.55
},
{
"date": "2026-01-26T00:00:00+00:00",
"count": 5393.57
},
{
"date": "2026-01-27T00:00:00+00:00",
"count": 3874.12
},
{
"date": "2026-01-28T00:00:00+00:00",
"count": 6735.14
},
{
"date": "2026-01-29T00:00:00+00:00",
"count": 7908.03
},
{
"date": "2026-01-30T00:00:00+00:00",
"count": 11120.55
},
{
"date": "2026-01-31T00:00:00+00:00",
"count": 12434.52
},
{
"date": "2026-02-01T00:00:00+00:00",
"count": 6016.15
},
{
"date": "2026-02-02T00:00:00+00:00",
"count": 3772.66
},
{
"date": "2026-02-03T00:00:00+00:00",
"count": 5710.38
},
{
"date": "2026-02-04T00:00:00+00:00",
"count": 5652.75
},
{
"date": "2026-02-05T00:00:00+00:00",
"count": 6934.73
},
{
"date": "2026-02-06T00:00:00+00:00",
"count": 5046.19
}
],
"total": 179903.2,
"delta": 26.6
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 11270560,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4998,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}