Mass Messages

List Mass Message Buyers

Returns the fans who purchased a specific PPV mass message — the drill-down behind a queue row. Mass Message Statistics reports sentCount and viewedCount per message but carries no purchaser attribution; this endpoint is where that lives. Requires permission api_mass_messages_list_buyers.

https://public-api.fansmetric.com

GET/v1/{account_id}/mass-messages/queue/{queue_id}/buyers

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.
queue_id*integer
The queue ID of the mass message — from the queue list or Mass Message Statistics rows.

Query Parameters

limitinteger
Buyers per page. Default 10. Min 1, max 100.
offsetinteger
Pagination offset.
markerstring
Snapshot pin from a prior response. Omit on the first page — OnlyFans picks a pin and returns it in data.marker; pass it back unchanged on later pages.

Response Fields

data.list[]array
Buyers in this page — ID-only stubs.
data.list[].idinteger
The fan's OnlyFans user ID.
data.list[]._viewstring
OnlyFans internal view marker. Ignore.
data.markerinteger
Snapshot pin. Pass back unchanged while paginating.
data.hasMoreboolean
Whether more buyers remain beyond this page.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_pagination.next_pagestring
Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.list[]	array	Buyers in this page — ID-only stubs.
data.list[].id	integer	The fan's OnlyFans user ID.
data.list[]._view	string	OnlyFans internal view marker. Ignore.
data.marker	integer	Snapshot pin. Pass back unchanged while paginating.
data.hasMore	boolean	Whether more buyers remain beyond this page.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_pagination.next_page	string	Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/mass-messages/queue/sample_queue_id/buyers?limit=20&offset=0&marker=sample_marker" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[0:{"id":378423681
"_view":"s"
}
]
"marker":1056676717
"hasMore":true
}
"_pagination":{"next_page":"/v1/100000001/mass-messages/queue/45990271701/buyers?limit=10&offset=10&marker=1056676717"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Mass Message

Update Mass Message