Mass Messaging
Get Mass Message Overview
Get an overview of mass messages, showing the send count and view count.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
start_date?string
The earliest mass message to retrieve. Keep empty to get all.
end_date?string
The latest mass message to retrieve. Keep empty to get all.
limit?integer
Number of mass messages to return (default = 10)
offset?integer
Number of mass messages to skip for pagination
query?string
Optionally, find a mass message by the message text.
Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/mass-messaging/overview?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&limit=10&offset=0&query=My+message+text"{
"data": {
"hasMore": true,
"items": [
{
"id": 123,
"date": "2025-01-01T01:01:01+01:01",
"responseType": "message",
"text": "<p>Text</p>",
"rawText": "<p>Text</p>",
"giphyId": null,
"isFree": true,
"isMediaReady": true,
"mediaCount": 1,
"media": [
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T01:01:01+01:01",
"isReady": true,
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/.../image.jpg",
"width": 2335,
"height": 4175,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/.../image.jpg",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/.../image.jpg",
"width": 960,
"height": 1717,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/.../image.jpg",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
}
],
"previews": [],
"isTip": false,
"isReportedByMe": false,
"viewedCount": 123,
"sentCount": 123,
"isCanceled": false,
"template": "group",
"canUnsend": true,
"unsendSeconds": 1000000
}
]
},
"_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
}
}
}