Fans
An OnlyFans CRM API for fans, spend and lists
Know who you are talking to. Rank an account's fans by lifetime spend, open any fan for their subscription, spend by type, lists and the creator's notes, and see who is online right now.
# The 10 biggest spenders with an active subscription
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?status=active&sort=spend&limit=10" \
-H "Authorization: Bearer $BFL_KEY"
# One fan, read live from OnlyFans
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans/$FAN_ID?fresh=true" \
-H "Authorization: Bearer $BFL_KEY"Fan data API
Fan data for your OnlyFans CRM
Search and rank
Find fans by username or name, filter active or expired subscriptions and sort by spend, recent messages or newest subscription.
Lifetime spend
Lifetime spend split by type, gross and net, with the last purchase and last message times.
Lists and notes
The OnlyFans lists a fan is on and the creator's private note about them.
Who is online
Fans online right now, with their spend. A fan missing from the list is not known to be offline, and the API says unknown instead of guessing.
Live when it matters
Add ?fresh=true to a fan profile or the online list to read it live from OnlyFans.
Organize with approval
Ask to add a fan to a list or remove them. The change waits for your team's approval by default.
FAQ
Frequently asked questions
Can I export OnlyFans subscribers through an API?
Yes. GET /v1/accounts/{accountId}/fans pages through an account's fans, active, expired or all, with a cursor. Each fan comes with subscription dates and lifetime spend, so you can load them into a CRM or a spreadsheet.
How do I find a creator's biggest spenders?
Call the fans route with sort=spend, or use the find_fans tool in your AI client. Spend comes from the fan's transactions, split into gross and net.
How do I see which fans are online?
GET /v1/accounts/{accountId}/online-fans lists fans online now with their spend. Add ?fresh=true for a live read. Presence can be online, offline or unknown, and unknown never means offline.
Related
Related features
GET STARTED
Build it in test mode today.
Sign up, make a test key and work against sandbox creators. Link a real account when your flow is ready.
Questions first? Write to hello@betterfans.link.