OnlyFans API DocumentationOnlyFans API
Fans

List Top Fans

List the top-spending fans of a connected OnlyFans account within a date range.

Get the fans who spent the most within a date range, ranked by a spending category. The range defaults to the last 30 days. users is empty when no fan spent anything in the range.

https://v1.onlyfansapi.io
GET
/api/{acct_id}/fans/top

Headers

x-api-key*
string
Your API key. See Authentication.

Path Parameters

acct_id*
string
The connected account to read from, as returned by Authenticate Account.

Query Parameters

startDate ?
string
Start of the range, UTC. Accepts YYYY-MM-DD, YYYY-MM-DD HH:MM:SS or ISO 8601. Defaults to 30 days before endDate.
endDate ?
string
End of the range, UTC. A bare date covers the whole day. Defaults to now.
by ?
string
Spending category to rank by: total, subscriptions, tips, messages, posts or streams. Defaults to total.
offset ?
integer
Number of fans to skip, for pagination. Defaults to 0.