Engagement / Messages
Mass Messages
List sent mass messages with engagement stats (sent, viewed, purchased, etc.).
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
The earliest message to retrieve. Keep empty to get all.
endDate?string
The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER startDate. This is also used for pagination.
limit?integer
Number of messages to return (default = 10)
query?string
Optionally, filter by message text.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/engagement/messages/mass-messages?startDate=2026-01-07+00%3A00%3A00&endDate=2026-02-06+01%3A26%3A15&limit=10&query=sciss"{
"data": {
"hasMore": true,
"items": [
{
"id": 1234567890,
"date": "2026-02-06T00:51:23+00:00",
"responseType": "message",
"text": "<p>Lets play ADULT ROCK-PAPER-SCISSORS babe, shall we?</p>",
"rawText": "Lets play ADULT ROCK-PAPER-SCISSORS babe, shall we?",
"giphyId": null,
"isFree": true,
"isMediaReady": true,
"mediaCount": 0,
"media": [],
"previews": [],
"isTip": false,
"isReportedByMe": false,
"viewedCount": 203,
"sentCount": 68400,
"isCanceled": false,
"template": "group",
"canUnsend": true,
"unsendSeconds": 1000000
}
]
},
"_pagination": {
"next_page": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXX/engagement/messages/mass-messages?endDate=2026-02-05%2011%3A06%3A57&limit=10"
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999959,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 998,
"remaining_day": 49988
}
}
}