NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
FanslyMass Messaging

List Mass Message Stats

List the account's sent broadcasts (newest first) with their statistics — or deleted broadcasts with deleted=true. These are the broadcasts shown on the Fansly dashboard's Broadcast Message Stats page.

For each message, stats.total is the number of recipients the broadcast could reach (not confirmed deliveries — permissions or long inactivity can prevent delivery) and stats.read is how many opened it. Fansly has no per-message purchase counter: we add attachmentSaleStats (sales, total, pending), summed from the saleStats of the message's attached media in accountMedia / accountMediaBundles, the same way the dashboard calculates it. Because those are the media's own sales, they also include purchases of the same media from other posts or mass messages, so summing them across broadcasts can double-count revenue.

To fetch the next page, pass the id of the last returned message as before.

A sent message's id is what the Unsend Sent Mass Message endpoint takes.

GET
/api/fansly/{fanslyAccount}/mass-messaging/stats
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

fanslyAccount*string

The Fansly Account ID

Query Parameters

before?string

Pagination cursor: the id of the last message from the previous page. Omit (or pass 0) for the first page.

limit?integer

Number of broadcasts to return, 1–100. Defaults to 24.

deleted?boolean

List deleted broadcasts instead of sent ones.

Request Body

application/json

before?string|null
limit?integer|null

Must be at least 1. Must not be greater than 100.

deleted?boolean|null

Response Body

application/json

curl -X GET "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/mass-messaging/stats?before=0&limit=24&deleted=false" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "messages": [
      {
        "id": "300000000000000040",
        "type": 1,
        "content": "Hey everyone, new content is live!",
        "groupId": "200000000000000030",
        "senderId": "800000000000000001",
        "createdAt": 1785110912,
        "attachments": [
          {
            "messageId": "300000000000000040",
            "pos": 0,
            "contentId": "500000000000000001",
            "contentType": 1
          }
        ],
        "stats": {
          "total": 1250,
          "read": 430
        },
        "attachmentSaleStats": {
          "sales": 12,
          "total": 120000,
          "pending": 0
        }
      }
    ],
    "accountMedia": [
      {
        "id": "500000000000000001",
        "accountId": "800000000000000001",
        "mediaId": "800000000000000010",
        "saleStats": {
          "sales": 12,
          "total": 120000,
          "pending": 0
        }
      }
    ],
    "accountMediaBundles": [],
    "tips": [],
    "tipGoals": []
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 10055789,
      "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."
    }
  }
}