Subscribers
Top Supporters
Retrieve a ranked list of top supporters for a specific account, including aggregated spend and subscription data for each supporter.
https://v1.apifansly.com
GET
/api/fansly/{accountId}/top-supporters
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
Path Parameters
accountId*
stringThe internal ID of the connected Fansly account.
Query Parameters
before ?
numberUnix timestamp (ms). Returns supporters from before this date.
after ?
numberUnix timestamp (ms). Returns supporters from after this date.
curl -X GET "https://v1.apifansly.com/api/fansly/{accountId}/top-supporters" \
-H "x-api-key: YOUR_API_KEY"fetch("https://v1.apifansly.com/api/fansly/{accountId}/top-supporters", {
method: "GET",
headers: {
"x-api-key": "YOUR_API_KEY"
}
})import requests
url = "https://v1.apifansly.com/api/fansly/{accountId}/top-supporters"
headers = {"x-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://v1.apifansly.com/api/fansly/{accountId}/top-supporters"))
.header("x-api-key", "YOUR_API_KEY")
.GET()
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var response = await client.GetAsync("https://v1.apifansly.com/api/fansly/{accountId}/top-supporters");
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://v1.apifansly.com/api/fansly/{accountId}/top-supporters"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}Response
{
"statusCode": 200,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": [
{
"totalGross": 50000,
"totalNet": 40000,
"accountId": "XXxxxxxxxxxxxxxxxxxx",
"correlationAccountId": "XXxxxxxxxxxxxxxxxxxx"
},
{
"totalGross": 15000,
"totalNet": 12000,
"accountId": "XXxxxxxxxxxxxxxxxxxx",
"correlationAccountId": "XXxxxxxxxxxxxxxxxxxx"
}
]
}
},
"timestamp": "2026-03-15T23:48:39.503Z"
}Response Fields
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the response |
message | string | Result status message |
data | object | Main response payload |
├─ data | object | Fansly specific data |
│ └─ response | array | Ordered array of top supporter objects |
│ ├─── totalGross | number | Total gross revenue from this supporter (in cents) |
│ ├─── totalNet | number | Total net revenue after fees (in cents) |
│ ├─── accountId | string | The connected Fansly account ID (your account) |
│ └─── correlationAccountId | string | The supporter's Fansly account ID |
timestamp | string | ISO 8601 timestamp of the response |