Skip to content

Fansly fans

A Fansly fan data API for your CRM

Know who you are talking to on Fansly. Rank an account's fans by lifetime spend, page through active or expired subscribers, and open any fan for their subscription, spend by type and the lists they are on.

fansly-fans.sh
# Active subscribers, biggest spenders first
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?status=active&sort=spend&limit=100" \
  -H "Authorization: Bearer $BFL_KEY"

# The next page, until there is no nextCursor
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?status=active&sort=spend&limit=100&cursor=$NEXT_CURSOR" \
  -H "Authorization: Bearer $BFL_KEY"

Fansly fan data

What your CRM can read about Fansly fans

Search and rank

Find fans by username or name, filter active or expired subscriptions and sort by spend, last message or newest subscription.

Subscriptions

Status, start and end dates, whether it renews and its price, for every fan.

Lifetime spend

Gross and net per fan, split into subscriptions, tips and other, with the last purchase and last message times. Message and post purchases count in other.

Fan lists

The account's lists with their sizes, and the lists each fan is on.

Live profile

Add ?fresh=true to a fan to read their profile live from Fansly.

Export in pages

Page through every fan with a cursor, up to 100 at a time, to fill a CRM or a spreadsheet.

FAQ

Frequently asked questions

Can I export Fansly subscribers through an API?

Yes. GET /v1/accounts/{accountId}/fans pages through a Fansly account's fans, active, expired or all, up to 100 at a time with a cursor. Each fan comes with subscription dates and lifetime spend, ready for a CRM or a spreadsheet.

How is a Fansly fan's spend worked out?

From the fan's transactions on that account. Get fan returns lifetime gross and net, split into subscriptions, tips and other. Fansly reports message and post purchases together, so they count in other, and messages and posts read 0. Net is what the creator keeps after the platform fee, so report one or the other and never add them together.

Can I see which Fansly fans are online?

Yes. GET /v1/accounts/{accountId}/online-fans lists the fans seen online in the last 30 minutes. Add ?fresh=true to check live with Fansly, which covers up to 500 of the account's fans, most recently seen first. Fansly does not say when a fan came online, so since is null.

Can I add Fansly fans to a list through the API?

No. You can read the account's lists and the lists each fan is on, but add_fan_to_list and remove_fan_from_list work on OnlyFans and Fanvue only. On a Fansly account they answer not_supported_on_platform.

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.