ONonlyfansapi
Engagement / Messages

Direct Messages

Changed on

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

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

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/{account}/engagement/messages/direct-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
offsetinteger

Optional offset for manual pagination.

Response

Example response

{
  "data": {
    "hasMore": true,
    "items": [
      {
        "id": 2233445566,
        "date": "2026-02-06T01:20:15+00:00",
        "responseType": "message",
        "text": "<p>SCISSORS</p>",
        "rawText": "SCISSORS",
        "giphyId": null,
        "isFree": false,
        "isMediaReady": true,
        "mediaCount": 1,
        "media": [
          {
            "id": 3344556677,
            "type": "photo",
            "convertedToVideo": false,
            "canView": true,
            "hasError": false,
            "createdAt": "2025-03-30T23:06:00+00:00",
            "isReady": true,
            "files": {
              "full": {
                "url": "https://cdn.example.com/files/placeholder/image.jpg",
                "width": 2801,
                "height": 3735,
                "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": 1281,
                "size": 0
              },
              "squarePreview": {
                "url": "https://cdn.example.com/files/placeholder/square.jpg",
                "width": 960,
                "height": 960,
                "size": 0
              }
            },
            "duration": 0,
            "hasCustomPreview": false,
            "videoSources": {
              "240": null,
              "720": null
            }
          }
        ],
        "previews": [],
        "isTip": false,
        "isReportedByMe": false,
        "viewedCount": 0,
        "sentCount": 1,
        "isCanceled": false,
        "template": "direct",
        "messageId": 4455667788990,
        "toUserId": 55667788,
        "canUnsend": true,
        "unsendSeconds": 1000000,
        "price": "29.99",
        "purchasedCount": 0,
        "canSendMessageToBuyers": false
      }
    ]
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXX/engagement/messages/direct-messages?endDate=2026-02-06%2002%3A53%3A05&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