ONonlyfansapi
Engagement / Messages

Top Message

Changed on

Get the top performing message by purchases in the selected timeframe.

get/api/{account}/engagement/messages/top-message

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/{account}/engagement/messages/top-message
  • Auth
    HTTP bearer

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
endDatestring

The end date for the period. Keep empty to retrieve until now. It must be after startDate.

Example:2026-02-06 01:26:15

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."
    }
  }
}

Changes