Engagement / Messages
Mass Messages
List sent mass messages with engagement stats (sent, viewed, purchased, etc.).
get/api/{account}/engagement/messages/mass-messages
Query parameters
startDatestring
The earliest message to retrieve. Keep empty to get all.
Example:2026-01-07 00:00:00
The earliest message to retrieve. Keep empty to get all.
endDatestring
The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER startDate. This is also used for pagination.
Example:2026-02-06 01:26:15
The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER startDate. This is also used for pagination.
limitinteger
Number of messages to return (default = 10)
Example:10
Number of messages to return (default = 10)
querystring
Optionally, filter by message text.
Example:sciss
Optionally, filter by message text.
Response
Example response
{
"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
}
}
}