Mass messaging
List Mass Message Statistics
List mass messaging statistics, showing the send count and view count.
AuthorizationBearer <token>
You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
limit?integer
Number of mass messages to return (default = 20)
offset?integer
Number of mass messages to skip for pagination
query?string
Optionally, find a mass message by the message text.
type?string
Filter by sent / scheduled / unsent (default = sent)
Value in
"sent" | "scheduled" | "unsent"Response Body
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent"fetch("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent")package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import requests
url = "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent"
response = requests.request("GET", url)
print(response.text)import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
.uri(URI.create("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent"))
.GET()
.build();
try {
HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
System.out.println("Status code: " + response.statusCode());
System.out.println("Response body: " + response.body());
} catch (Exception e) {
e.printStackTrace();
}using System;
using System.Net.Http;
using System.Text;
var client = new HttpClient();
var response = await client.GetAsync("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/mass-messaging/statistics?limit=20&query=My+message+text&type=sent");
var responseBody = await response.Content.ReadAsStringAsync();{
"data": {
"list": [
{
"id": 123,
"date": "2025-01-01T01:01:01+01:01",
"text": "<p>Text</p>",
"giphyId": null,
"textCropped": "<p>Text</p>",
"isFree": true,
"sentCount": 123,
"viewedCount": 123,
"canUnsend": true,
"unsendSeconds": 1000000,
"isCanceled": false,
"mediaTypes": null,
"hasError": false,
"releaseForms": []
},
{
"id": 124,
"date": "2025-01-01T01:01:01+01:01",
"text": "<p>PPV Example</p>",
"giphyId": null,
"textCropped": "<p>PPV Example</p>",
"isFree": false,
"sentCount": 0,
"viewedCount": 0,
"canUnsend": false,
"unsendSeconds": 0,
"isCanceled": true,
"mediaTypes": {
"photo": 2
},
"hasError": false,
"price": "5.00",
"purchasedCount": 0,
"canSendMessageToBuyers": false,
"releaseForms": []
}
],
"hasMore": false
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999990,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 60,
"limit_day": 500,
"remaining_minute": 59,
"remaining_day": 484
}
}
}