Skip to content

Fansly API

A Fansly API for agencies and developers

Fansly does not publish an API for developers. BetterFans Link gives you one for the Fansly accounts linked to your workspace: a REST API with the same routes and keys as OnlyFans. AI clients can read the same data over MCP.

fansly.sh
# Every Fansly account your key can use, with its status
curl "https://betterfans.link/v1/accounts?platform=fansly" \
  -H "Authorization: Bearer $BFL_KEY"

# Its biggest spenders. Fansly ids are long, so keep them as strings.
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?sort=spend&limit=10" \
  -H "Authorization: Bearer $BFL_KEY"

# Anything else Fansly shows, read live
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fansly/account/me" \
  -H "Authorization: Bearer $BFL_KEY"

Does Fansly have an API?

No. Fansly publishes no public developer API, no API keys and no documentation. BetterFans Link works only with Fansly accounts linked to your workspace, and gives you documented routes, API keys, account and action webhooks and an MCP server. It is not affiliated with or endorsed by Fansly.

Reads

What you can read on Fansly

The same routes as OnlyFans, with the same keys.

Fans and subscribers

Search and rank fans by spend or recency, with subscription status and dates, lifetime spend by type and the lists they are on.

Chats and messages

Chats with unread counts and spend, the messages in each one and full text search across the account.

Revenue and transactions

Gross and net for any period, split by type and as a series, with top fans. Each sale with its fan, gross, net and fee.

Posts and tracking links

Posts by likes or date with price, likes, comments and the tips each one earned. Tracking links with clicks, subscribers and revenue.

The vault

Every photo, video, audio clip and GIF by folder and type, with the ids to attach to a message.

Anything else Fansly shows

Call Fansly reads anything else Fansly shows, live. Reads only.

Writes

What you can send

Each write is an action with a plain summary in the dashboard. AI clients that sign in with OAuth wait for your team to approve each write.

Free messages

Send a fan a message with free vault media attached. Fansly sends are always free, so leave out priceCents.

To chats that exist

A Fansly send goes to the chat the account already has with that fan. Without one, nothing is sent and the action ends failed.

Take one back

An unsend_message action removes a message you sent.

Linking

How a Fansly creator connects

A Fansly account can be connected to one workspace at a time. Its status is Healthy, Syncing, Awaiting 2FA, Needs relink or Disconnected. What each status means

FAQ

Fansly API questions

How is this different from a Fansly scraper?

A scraper collects public pages from the outside. BetterFans Link works only inside Fansly accounts linked to your workspace, so it reads what the creator sees: fans, chats, earnings, posts and the vault. Linking an account takes its own sign-in details and any code Fansly asks for.

How fresh is Fansly data?

New Fansly messages, sales and subscribers usually arrive within a minute, and a full sync about every 30 minutes catches anything missed. When you need a chat, a fan or who is online right now, you can read it live from Fansly instead. The docs show how.

Can I try the Fansly API without a Fansly account?

Yes. Test mode has Sloane, a sandbox creator on Fansly with sample fans, chats and revenue, next to the three OnlyFans sandbox creators and Marlo on Fanvue. Use a bfl_test_ key to build against her, and test sends record a simulated result without reaching Fansly.

The password is encrypted before it is stored, and the dashboard and the API never show it. We never change the creator's password, email or settings, and removing the account stops our access without signing the creator out of Fansly.

GET STARTED

Build it in test mode today.

Sign up, make a test key and build against Sloane, the Fansly sandbox creator. Link a real Fansly account when your flow is ready.

Questions first? Write to hello@betterfans.link.