OnlyFans API
Statistics | statements

Get Earnings

Get the earnings for a given period.

GET
/api/{account}/statistics/statements/earnings
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

start_datestring

The start date for the period

end_datestring

The end date for the period.

type?string

Filter by Total / Guests / Users

Value in"total" | "guests" | "users"

Response Body

curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total"
fetch("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total")
package main

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

func main() {
  url := "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total"

  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/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total"

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/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total"))
  .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/statistics/statements/earnings?start_date=2025-01-01+00%3A00%3A00&end_date=2025-03-31+23%3A59%3A59&type=total");
var responseBody = await response.Content.ReadAsStringAsync();
{
  "data": {
    "total": {
      "delta": -6.9,
      "chartCount": [
        {
          "date": "2025-01-01T00:00:00+00:00",
          "count": 540
        },
        {
          "date": "2025-01-02T00:00:00+00:00",
          "count": 451
        },
        {
          "date": "2025-01-03T00:00:00+00:00",
          "count": 501
        },
        {
          "date": "2025-01-04T00:00:00+00:00",
          "count": 417
        },
        {
          "date": "2025-01-05T00:00:00+00:00",
          "count": 515
        },
        {
          "date": "2025-01-06T00:00:00+00:00",
          "count": 488
        },
        {
          "date": "2025-01-07T00:00:00+00:00",
          "count": 481
        },
        {
          "date": "2025-01-08T00:00:00+00:00",
          "count": 444
        },
        {
          "date": "2025-01-09T00:00:00+00:00",
          "count": 510
        },
        {
          "date": "2025-01-10T00:00:00+00:00",
          "count": 424
        },
        {
          "date": "2025-01-11T00:00:00+00:00",
          "count": 360
        },
        {
          "date": "2025-01-12T00:00:00+00:00",
          "count": 396
        },
        {
          "date": "2025-01-13T00:00:00+00:00",
          "count": 434
        },
        {
          "date": "2025-01-14T00:00:00+00:00",
          "count": 392
        },
        {
          "date": "2025-01-15T00:00:00+00:00",
          "count": 368
        },
        {
          "date": "2025-01-16T00:00:00+00:00",
          "count": 402
        },
        {
          "date": "2025-01-17T00:00:00+00:00",
          "count": 393
        },
        {
          "date": "2025-01-18T00:00:00+00:00",
          "count": 360
        },
        {
          "date": "2025-01-19T00:00:00+00:00",
          "count": 438
        },
        {
          "date": "2025-01-20T00:00:00+00:00",
          "count": 420
        },
        {
          "date": "2025-01-21T00:00:00+00:00",
          "count": 314
        },
        {
          "date": "2025-01-22T00:00:00+00:00",
          "count": 384
        },
        {
          "date": "2025-01-23T00:00:00+00:00",
          "count": 408
        },
        {
          "date": "2025-01-24T00:00:00+00:00",
          "count": 384
        },
        {
          "date": "2025-01-25T00:00:00+00:00",
          "count": 468
        },
        {
          "date": "2025-01-26T00:00:00+00:00",
          "count": 609
        },
        {
          "date": "2025-01-27T00:00:00+00:00",
          "count": 514
        },
        {
          "date": "2025-01-28T00:00:00+00:00",
          "count": 438
        },
        {
          "date": "2025-01-29T00:00:00+00:00",
          "count": 421
        },
        {
          "date": "2025-01-30T00:00:00+00:00",
          "count": 494
        },
        {
          "date": "2025-01-31T00:00:00+00:00",
          "count": 487
        },
        {
          "date": "2025-02-01T00:00:00+00:00",
          "count": 523
        },
        {
          "date": "2025-02-02T00:00:00+00:00",
          "count": 572
        },
        {
          "date": "2025-02-03T00:00:00+00:00",
          "count": 468
        },
        {
          "date": "2025-02-04T00:00:00+00:00",
          "count": 433
        },
        {
          "date": "2025-02-05T00:00:00+00:00",
          "count": 544
        },
        {
          "date": "2025-02-06T00:00:00+00:00",
          "count": 641
        },
        {
          "date": "2025-02-07T00:00:00+00:00",
          "count": 524
        },
        {
          "date": "2025-02-08T00:00:00+00:00",
          "count": 522
        },
        {
          "date": "2025-02-09T00:00:00+00:00",
          "count": 454
        },
        {
          "date": "2025-02-10T00:00:00+00:00",
          "count": 596
        },
        {
          "date": "2025-02-11T00:00:00+00:00",
          "count": 540
        },
        {
          "date": "2025-02-12T00:00:00+00:00",
          "count": 466
        },
        {
          "date": "2025-02-13T00:00:00+00:00",
          "count": 519
        },
        {
          "date": "2025-02-14T00:00:00+00:00",
          "count": 513
        },
        {
          "date": "2025-02-15T00:00:00+00:00",
          "count": 487
        },
        {
          "date": "2025-02-16T00:00:00+00:00",
          "count": 412
        },
        {
          "date": "2025-02-17T00:00:00+00:00",
          "count": 404
        },
        {
          "date": "2025-02-18T00:00:00+00:00",
          "count": 472
        },
        {
          "date": "2025-02-19T00:00:00+00:00",
          "count": 355
        },
        {
          "date": "2025-02-20T00:00:00+00:00",
          "count": 481
        },
        {
          "date": "2025-02-21T00:00:00+00:00",
          "count": 485
        },
        {
          "date": "2025-02-22T00:00:00+00:00",
          "count": 439
        },
        {
          "date": "2025-02-23T00:00:00+00:00",
          "count": 412
        },
        {
          "date": "2025-02-24T00:00:00+00:00",
          "count": 434
        },
        {
          "date": "2025-02-25T00:00:00+00:00",
          "count": 397
        },
        {
          "date": "2025-02-26T00:00:00+00:00",
          "count": 368
        },
        {
          "date": "2025-02-27T00:00:00+00:00",
          "count": 518
        },
        {
          "date": "2025-02-28T00:00:00+00:00",
          "count": 565
        },
        {
          "date": "2025-03-01T00:00:00+00:00",
          "count": 564
        },
        {
          "date": "2025-03-02T00:00:00+00:00",
          "count": 581
        },
        {
          "date": "2025-03-03T00:00:00+00:00",
          "count": 444
        },
        {
          "date": "2025-03-04T00:00:00+00:00",
          "count": 457
        },
        {
          "date": "2025-03-05T00:00:00+00:00",
          "count": 507
        },
        {
          "date": "2025-03-06T00:00:00+00:00",
          "count": 510
        },
        {
          "date": "2025-03-07T00:00:00+00:00",
          "count": 474
        },
        {
          "date": "2025-03-08T00:00:00+00:00",
          "count": 543
        },
        {
          "date": "2025-03-09T00:00:00+00:00",
          "count": 529
        },
        {
          "date": "2025-03-10T00:00:00+00:00",
          "count": 520
        },
        {
          "date": "2025-03-11T00:00:00+00:00",
          "count": 498
        },
        {
          "date": "2025-03-12T00:00:00+00:00",
          "count": 457
        },
        {
          "date": "2025-03-13T00:00:00+00:00",
          "count": 497
        },
        {
          "date": "2025-03-14T00:00:00+00:00",
          "count": 532
        },
        {
          "date": "2025-03-15T00:00:00+00:00",
          "count": 491
        },
        {
          "date": "2025-03-16T00:00:00+00:00",
          "count": 413
        },
        {
          "date": "2025-03-17T00:00:00+00:00",
          "count": 426
        },
        {
          "date": "2025-03-18T00:00:00+00:00",
          "count": 491
        },
        {
          "date": "2025-03-19T00:00:00+00:00",
          "count": 386
        },
        {
          "date": "2025-03-20T00:00:00+00:00",
          "count": 476
        },
        {
          "date": "2025-03-21T00:00:00+00:00",
          "count": 420
        },
        {
          "date": "2025-03-22T00:00:00+00:00",
          "count": 426
        },
        {
          "date": "2025-03-23T00:00:00+00:00",
          "count": 533
        },
        {
          "date": "2025-03-24T00:00:00+00:00",
          "count": 406
        },
        {
          "date": "2025-03-25T00:00:00+00:00",
          "count": 400
        },
        {
          "date": "2025-03-26T00:00:00+00:00",
          "count": 435
        },
        {
          "date": "2025-03-27T00:00:00+00:00",
          "count": 514
        },
        {
          "date": "2025-03-28T00:00:00+00:00",
          "count": 503
        },
        {
          "date": "2025-03-29T00:00:00+00:00",
          "count": 446
        },
        {
          "date": "2025-03-30T00:00:00+00:00",
          "count": 437
        },
        {
          "date": "2025-03-31T00:00:00+00:00",
          "count": 415
        }
      ],
      "chartAmount": [
        {
          "date": "2025-01-01T00:00:00+00:00",
          "count": 10051.89
        },
        {
          "date": "2025-01-02T00:00:00+00:00",
          "count": 7044.43
        },
        {
          "date": "2025-01-03T00:00:00+00:00",
          "count": 9070.46
        },
        {
          "date": "2025-01-04T00:00:00+00:00",
          "count": 7575.49
        },
        {
          "date": "2025-01-05T00:00:00+00:00",
          "count": 7459.01
        },
        {
          "date": "2025-01-06T00:00:00+00:00",
          "count": 8472.68
        },
        {
          "date": "2025-01-07T00:00:00+00:00",
          "count": 6410.23
        },
        {
          "date": "2025-01-08T00:00:00+00:00",
          "count": 6336.6
        },
        {
          "date": "2025-01-09T00:00:00+00:00",
          "count": 8475.93
        },
        {
          "date": "2025-01-10T00:00:00+00:00",
          "count": 7673.4
        },
        {
          "date": "2025-01-11T00:00:00+00:00",
          "count": 7666.22
        },
        {
          "date": "2025-01-12T00:00:00+00:00",
          "count": 8126.65
        },
        {
          "date": "2025-01-13T00:00:00+00:00",
          "count": 6278.71
        },
        {
          "date": "2025-01-14T00:00:00+00:00",
          "count": 7210.6
        },
        {
          "date": "2025-01-15T00:00:00+00:00",
          "count": 4610.57
        },
        {
          "date": "2025-01-16T00:00:00+00:00",
          "count": 5739.87
        },
        {
          "date": "2025-01-17T00:00:00+00:00",
          "count": 8435.22
        },
        {
          "date": "2025-01-18T00:00:00+00:00",
          "count": 5237.74
        },
        {
          "date": "2025-01-19T00:00:00+00:00",
          "count": 7315.44
        },
        {
          "date": "2025-01-20T00:00:00+00:00",
          "count": 7325.59
        },
        {
          "date": "2025-01-21T00:00:00+00:00",
          "count": 4510.83
        },
        {
          "date": "2025-01-22T00:00:00+00:00",
          "count": 6901.88
        },
        {
          "date": "2025-01-23T00:00:00+00:00",
          "count": 5442.49
        },
        {
          "date": "2025-01-24T00:00:00+00:00",
          "count": 6517.01
        },
        {
          "date": "2025-01-25T00:00:00+00:00",
          "count": 6882.58
        },
        {
          "date": "2025-01-26T00:00:00+00:00",
          "count": 8778.25
        },
        {
          "date": "2025-01-27T00:00:00+00:00",
          "count": 7759.99
        },
        {
          "date": "2025-01-28T00:00:00+00:00",
          "count": 6750.44
        },
        {
          "date": "2025-01-29T00:00:00+00:00",
          "count": 6338.93
        },
        {
          "date": "2025-01-30T00:00:00+00:00",
          "count": 7249.22
        },
        {
          "date": "2025-01-31T00:00:00+00:00",
          "count": 6299.92
        },
        {
          "date": "2025-02-01T00:00:00+00:00",
          "count": 8327.3
        },
        {
          "date": "2025-02-02T00:00:00+00:00",
          "count": 7675.32
        },
        {
          "date": "2025-02-03T00:00:00+00:00",
          "count": 7153.73
        },
        {
          "date": "2025-02-04T00:00:00+00:00",
          "count": 6711.74
        },
        {
          "date": "2025-02-05T00:00:00+00:00",
          "count": 7334.76
        },
        {
          "date": "2025-02-06T00:00:00+00:00",
          "count": 13641.27
        },
        {
          "date": "2025-02-07T00:00:00+00:00",
          "count": 9280.8
        },
        {
          "date": "2025-02-08T00:00:00+00:00",
          "count": 7978.69
        },
        {
          "date": "2025-02-09T00:00:00+00:00",
          "count": 8561.71
        },
        {
          "date": "2025-02-10T00:00:00+00:00",
          "count": 6979.16
        },
        {
          "date": "2025-02-11T00:00:00+00:00",
          "count": 7040.23
        },
        {
          "date": "2025-02-12T00:00:00+00:00",
          "count": 6701.16
        },
        {
          "date": "2025-02-13T00:00:00+00:00",
          "count": 7418.89
        },
        {
          "date": "2025-02-14T00:00:00+00:00",
          "count": 9174.97
        },
        {
          "date": "2025-02-15T00:00:00+00:00",
          "count": 8956.52
        },
        {
          "date": "2025-02-16T00:00:00+00:00",
          "count": 6561.58
        },
        {
          "date": "2025-02-17T00:00:00+00:00",
          "count": 5060.88
        },
        {
          "date": "2025-02-18T00:00:00+00:00",
          "count": 7721.78
        },
        {
          "date": "2025-02-19T00:00:00+00:00",
          "count": 6096.49
        },
        {
          "date": "2025-02-20T00:00:00+00:00",
          "count": 7017.78
        },
        {
          "date": "2025-02-21T00:00:00+00:00",
          "count": 9542.37
        },
        {
          "date": "2025-02-22T00:00:00+00:00",
          "count": 6882.54
        },
        {
          "date": "2025-02-23T00:00:00+00:00",
          "count": 5805.24
        },
        {
          "date": "2025-02-24T00:00:00+00:00",
          "count": 6612.35
        },
        {
          "date": "2025-02-25T00:00:00+00:00",
          "count": 4801.5
        },
        {
          "date": "2025-02-26T00:00:00+00:00",
          "count": 5793.31
        },
        {
          "date": "2025-02-27T00:00:00+00:00",
          "count": 7420.45
        },
        {
          "date": "2025-02-28T00:00:00+00:00",
          "count": 7238.34
        },
        {
          "date": "2025-03-01T00:00:00+00:00",
          "count": 8843.12
        },
        {
          "date": "2025-03-02T00:00:00+00:00",
          "count": 8087.79
        },
        {
          "date": "2025-03-03T00:00:00+00:00",
          "count": 7389.51
        },
        {
          "date": "2025-03-04T00:00:00+00:00",
          "count": 5521.31
        },
        {
          "date": "2025-03-05T00:00:00+00:00",
          "count": 8213.56
        },
        {
          "date": "2025-03-06T00:00:00+00:00",
          "count": 8016.33
        },
        {
          "date": "2025-03-07T00:00:00+00:00",
          "count": 7856.66
        },
        {
          "date": "2025-03-08T00:00:00+00:00",
          "count": 7283.95
        },
        {
          "date": "2025-03-09T00:00:00+00:00",
          "count": 9228.49
        },
        {
          "date": "2025-03-10T00:00:00+00:00",
          "count": 7571.83
        },
        {
          "date": "2025-03-11T00:00:00+00:00",
          "count": 7476.63
        },
        {
          "date": "2025-03-12T00:00:00+00:00",
          "count": 6336.17
        },
        {
          "date": "2025-03-13T00:00:00+00:00",
          "count": 8253.78
        },
        {
          "date": "2025-03-14T00:00:00+00:00",
          "count": 7627.9
        },
        {
          "date": "2025-03-15T00:00:00+00:00",
          "count": 7304.9
        },
        {
          "date": "2025-03-16T00:00:00+00:00",
          "count": 7900.93
        },
        {
          "date": "2025-03-17T00:00:00+00:00",
          "count": 6035.48
        },
        {
          "date": "2025-03-18T00:00:00+00:00",
          "count": 8107.57
        },
        {
          "date": "2025-03-19T00:00:00+00:00",
          "count": 6584.91
        },
        {
          "date": "2025-03-20T00:00:00+00:00",
          "count": 7021.49
        },
        {
          "date": "2025-03-21T00:00:00+00:00",
          "count": 6801.75
        },
        {
          "date": "2025-03-22T00:00:00+00:00",
          "count": 7950.66
        },
        {
          "date": "2025-03-23T00:00:00+00:00",
          "count": 9653.96
        },
        {
          "date": "2025-03-24T00:00:00+00:00",
          "count": 6069.97
        },
        {
          "date": "2025-03-25T00:00:00+00:00",
          "count": 6746.01
        },
        {
          "date": "2025-03-26T00:00:00+00:00",
          "count": 6619.57
        },
        {
          "date": "2025-03-27T00:00:00+00:00",
          "count": 8570.96
        },
        {
          "date": "2025-03-28T00:00:00+00:00",
          "count": 8294.75
        },
        {
          "date": "2025-03-29T00:00:00+00:00",
          "count": 7005.74
        },
        {
          "date": "2025-03-30T00:00:00+00:00",
          "count": 7233.87
        },
        {
          "date": "2025-03-31T00:00:00+00:00",
          "count": 7037.54
        }
      ],
      "total": 662086.22,
      "gross": 827634.52
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 25579,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 5000,
      "remaining_minute": 997,
      "remaining_day": 4981
    }
  }
}