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

API keyBearer

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.

Response Fields

dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/subscribers/top?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59&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
}
}
}

List Following

List Latest Subscribers