FMFansMetric API

Subscribers

List Top Subscribers

Top subscribers ranked by activity within a date range. All four query params are optional — defaults match the OnlyFans web client (total spend over the last month). Requires permission api_subscribers_list_top.

https://public-api.fansmetric.com
GET/v1/{account_id}/subscribers/top
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Query Parameters

  • start_datestring

    UTC start of the window. Format YYYY-MM-DD HH:MM:SS (ISO 8601 with T accepted — we convert it to a space). Do not include a timezone suffix (Z / +00:00) — OnlyFans rejects it. Default: now − 1 month. Forwarded to OF as startDate.

  • end_datestring

    UTC end of the window. Same format as start_date. Default: now. Forwarded to OF as endDate.

  • bystring

    Ranking metric. One of total (lifetime spend — canonical "top by spend"), currency (spend within the window), recent, messages, posts, media. Default: total.

  • offsetinteger

    Pagination offset. OnlyFans pages this endpoint in fixed pages of 10 — pass multiples of 10. Default: 0. There is no limit parameter; page size is fixed upstream.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/subscribers/top?start_date=sample_start_date&end_date=sample_end_date&by=sample_by" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":1234567
"name":"Top Fan"
"username":"topfan"
"avatar":"https://public.onlyfans.com/.../avatar.jpg"
"subscribePrice":9.99
"isVerified":false
"spentTotal":1234.56
}
]
"hasMore":true
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

List Following

Next

List Latest Subscribers