Statistics
Statistics Overview
Get an overview of statistics for fans, visitors, posts, or general.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
start_date?string
The start date for the statistics. Keep empty to retrieve from the model's start date.
end_date?string
The end date for the statistics. Keep empty to retrieve until now.
type?string | null
The type of statistics to retrieve (default = empty)
Value in
"fans" | "visitors" | "posts" | "messages"Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/statistics/overview?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=fans"{
"data": {
"earning": {
"total": 123.45,
"gross": 123.45,
"delta": 1.6
},
"posts": {
"hasStatistic": true,
"count": {
"total": 123,
"delta": 0
},
"views": {
"total": 123,
"delta": -7.6
},
"chartData": [
{
"date": "2025-01-01T00:00:00+00:00",
"count": 123
}
],
"earnings": {
"total": 123,
"gross": 123,
"delta": 123
}
},
"streams": {
"hasStatistic": false,
"count": {
"total": "0m",
"delta": 0
},
"views": {
"total": 0,
"delta": 0
},
"chartData": [
{
"date": "2025-01-01T00:00:00+00:00",
"count": 123
}
],
"earnings": {
"total": 123,
"gross": 123,
"delta": 123
}
},
"visitors": {
"hasStatistic": true,
"visitors": {
"total": 0,
"delta": -100
},
"chartData": [
{
"date": "2025-01-01T00:00:00+00:00",
"count": 123
}
],
"earnings": {
"total": 123.45,
"gross": 123.45,
"delta": -10.9
},
"subscriptions": {
"new": {
"total": 123,
"delta": -5.7
},
"renew": {
"total": 123,
"delta": -17
}
}
},
"massMessages": {
"hasStatistic": true,
"count": {
"total": 123,
"delta": 14.5
},
"views": {
"total": 0,
"delta": 0
},
"chartData": [
{
"date": "2025-01-01T00:00:00+00:00",
"count": 123
}
],
"earnings": {
"total": 123.45,
"delta": -0.1,
"gross": 123.45
}
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999254,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 999,
"remaining_day": 49979
}
}
}Get Subscriber Statistics GET
Get subscriber and earning statistics for an account for a specified timeframe. Optionally, filter by all, renews, or new subscribers.
Calculate Chargeback Ratio GET
The Chargeback Ratio reflects the number of chargebacks compared to the total number of payments as a percentage. Ideally, your Chargeback Ratio should be under 1%.