ONonlyfansapi
Engagement / Messages

Mass Messages

Changed on

List sent mass messages with engagement stats (sent, viewed, purchased, etc.).

get/api/{account}/engagement/messages/mass-messages

Request

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

Query parameters

startDatestring

The earliest message to retrieve. Keep empty to get all.

Example:2026-01-07 00:00:00
endDatestring

The latest message to retrieve. Keep empty to get all. It must be after startDate and is also used for pagination.

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

Number of messages to return (default = 10)

Example:10
querystring

Optionally, filter by message text.

Example:sciss

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

Changes