Fansly API
The Fansly API for agencies and developers
Fansly does not publish an API for developers. BetterFans Link gives you one for the Fansly accounts creators link to your workspace: a REST API with the same routes, keys and approvals as OnlyFans. AI clients can read the same data over MCP.
# 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 through the account's session
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fansly/account/me" \
-H "Authorization: Bearer $BFL_KEY"Reads
What you can read on Fansly
The same routes as OnlyFans, from data synced about every 30 minutes. meta.asOf says how old it is.
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 runs any read-only Fansly API GET from our reviewed catalog, live, through the account's own session.
Writes
What you can send
Every write becomes an action that waits for an owner or admin to approve it, unless they gave the key auto-approve.
Free messages
Ask to send a fan a message with free vault media attached. A person on your team approves it before it goes out.
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. It waits for approval like every other write.
Linking
How a Fansly creator connects
- 01
Send a link
Make one in the dashboard or with POST /v1/links and platform fansly. It works for 24 hours.
- 02
The creator signs in
With their Fansly username or email and password, on our hosted page. You never see the password.
- 03
The code
If Fansly asks, the creator types the code from their email or authenticator app. No selfie, no human check.
- 04
Connected
The account joins your workspace, account.connected fires and the first sync starts.
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
OnlyFans only
What a Fansly account does not take
These routes and writes answer not_supported_on_platform for a Fansly account, before anything happens, and these events are never sent for one.
- REST routes
Mass messagesOnline fansCall OnlyFans- Webhook events
message.receivedtransaction.createdsubscriber.new
Features
Fansly API features
Fansly messaging
Read and search Fansly chats. Ask to send free DMs with vault media, and approve each one first.
Fansly earnings
Fansly revenue by type and period, every transaction, and the tips each post earned.
Fansly fan data
Rank Fansly subscribers by spend, with subscription dates, spend by type and lists.
Fansly agencies
Link many Fansly creators to one workspace, with roles, per-account keys and a log of every call.
Fansly MCP server
Connect Claude or Cursor to your Fansly creators. It reads and drafts, and you approve every send.
FAQ
Fansly API questions
Does Fansly have an official API?
Not one for developers. Fansly runs its own site and apps on an internal API, with no public keys or docs. BetterFans Link signs in as the creator, after they link their account on our hosted page, and gives you documented routes, API keys, webhooks and an MCP server on top.
How is this different from a Fansly scraper?
A scraper collects public pages from the outside. BetterFans Link works inside accounts that creators link to your workspace themselves, so it reads what the creator sees: fans, chats, earnings, posts and the vault. Nothing is linked without the creator signing in, and every write waits for approval.
How fresh is Fansly data?
Each Fansly account syncs about every 30 minutes: profile, inbox, subscribers, earnings, lists, links, posts and the vault, then the chats that moved. meta.asOf on every read says when. For a chat the account already has, or a fan profile, add ?fresh=true to read live from Fansly.
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. Use a bfl_test_ key to build against her, and test sends record a simulated result without reaching Fansly.
Is it safe for a creator to link their Fansly account?
The creator types their password on our hosted page, and it is encrypted before it is stored. Nobody in your workspace can see 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.