We just released our native n8n integration!» Try now
OnlyFans API
Statistics

Get Subscriber Metrics

Get subscriber metrics including total, new, renewed, paid, and free subscriptions for a specified timeframe. `unknown_subscriptions` indicates deleted fan accounts.

GET
/api/{account}/statistics/subscriber-metrics
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_datestring

The start date for the metrics.

end_datestring

The end date for the metrics.

detailed?boolean | null

Include paid and free fan metrics. Will slow down the response time, and might time out if timeframe is too large. Default = false

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/statistics/subscriber-metrics?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&detailed=false"
{
  "data": {
    "total_subscriptions": 10,
    "new_subscriptions": 5,
    "renewed_subscriptions": 5,
    "detailed": {
      "paid_subscriptions": 7,
      "free_subscriptions": 2,
      "unknown_subscriptions": 1
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999227,
      "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": 49952
    }
  }
}