Engagement / Messages
Top Message
Get the top performing message by purchases in the selected timeframe.
get/api/{account}/engagement/messages/top-message
Query parameters
startDatestring
The start date for the period. Keep empty to retrieve from the model start date.
Example:2026-01-07 00:00:00
The start date for the period. Keep empty to retrieve from the model start date.
endDatestring
The end date for the period. Keep empty to retrieve until now. MUST BE DATE AFTER startDate.
Example:2026-02-06 01:26:15
The end date for the period. Keep empty to retrieve until now. MUST BE DATE AFTER startDate.
Response
Example response
{
"data": {
"purchases": {
"id": 6677889900,
"date": "2024-06-30T12:53:42+00:00",
"responseType": "message",
"text": "This is the hardest i've ever been fucked... would you make me cum more than this?? 🥵💦",
"rawText": "This is the hardest i've ever been fucked... would you make me cum more than this?? 🥵💦",
"giphyId": null,
"isFree": false,
"isMediaReady": true,
"mediaCount": 1,
"media": [
{
"id": 7788990011,
"type": "video",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2023-01-31T13:14:15+00:00",
"isReady": true,
"files": {
"full": {
"url": "https://cdn.example.com/files/placeholder/video_source.mp4",
"width": 1080,
"height": 1920,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn.example.com/files/placeholder/thumb.jpg",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn.example.com/files/placeholder/preview.jpg",
"width": 960,
"height": 1707,
"size": 0
},
"squarePreview": {
"url": "https://cdn.example.com/files/placeholder/square.jpg",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 528,
"hasCustomPreview": false,
"videoSources": {
"240": "https://cdn.example.com/files/placeholder/video_240p.mp4",
"720": "https://cdn.example.com/files/placeholder/video_720p.mp4"
}
}
],
"previews": [],
"isTip": false,
"isReportedByMe": false,
"viewedCount": 9360,
"sentCount": 15802,
"isCanceled": true,
"template": "group",
"canUnsend": false,
"unsendSeconds": 0,
"price": "98.00",
"purchasedCount": 146,
"canSendMessageToBuyers": true,
"totalRevenueGenerated": "14308.00",
"relationships": {
"buyers": {
"href": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXX/engagement/messages/6677889900/buyers?limit=10&offset=0&skip_users_dups=1&marker=0",
"method": "GET"
}
}
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 11335469,
"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."
}
}
}