OnlyFans API
Payouts

Get Earning Statistics

Get total and monthly time-series earning statistics for the account.

GET
/api/{account}/payouts/earning-statistics
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

startDate?string

The start date for earning statistics. Keep empty to get all earnings.

endDate?string

The end date for earning statistics. Keep empty to get all earnings.

Response Body

curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days"
fetch("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days"

  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/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days"

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/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days"))
  .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/payouts/earning-statistics?startDate=2025-01-01+00%3A00%3A00%2C+-30days&endDate=2025-01-01+00%3A00%3A00%2C+%2B30days");
var responseBody = await response.Content.ReadAsStringAsync();
{
  "data": {
    "list": {
      "months": {
        "1735689661": {
          "tips": [
            {
              "time": 1735689661,
              "net": 4,
              "gross": 5
            }
          ],
          "total_net": 100,
          "total_gross": 125,
          "subscribes": [
            {
              "time": 1735689661,
              "net": 16,
              "gross": 20
            }
          ]
        }
      },
      "total": {
        "tips": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "all": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "subscribes": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "chat_messages": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "post": {
          "total_net": 123.45,
          "total_gross": 123.45
        }
      }
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999842,
      "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": 49846
    }
  }
}