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.
# 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
- 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 a page we host.
- 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 and account.connected fires.
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
Not on Fansly
What a Fansly account does not take
A route or write here answers not_supported_on_platform for a Fansly account, before anything happens. A webhook event here is never sent for one.
- REST routes
Mass messagesCall OnlyFansCall Fanvue- Webhook events
message.likedmessage.unlikedmessage.purchasedfan.onlinefanvue.payment.succeededfanvue.reward.createdfanvue.reward.reversedfanvue.refund.createdfanvue.dispute.flaggedfanvue.dispute.createdfanvue.subscription.activatedfanvue.subscription.renewedfanvue.subscription.deactivatedfanvue.subscription.cancel_at_period_end_changedfanvue.message.receivedfanvue.message.sentfanvue.message.mass_sentfanvue.message.readfanvue.message.read_by_fanfanvue.message.deletedfanvue.message.reactionfanvue.chat.marked_unreadfanvue.follow.createdfanvue.post.likedfanvue.post.commentedfanvue.fan.status_changedfanvue.fan.presence_changed
Features
Fansly API features
Fansly messaging
Read and search Fansly chats, and send free DMs with vault media.
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 fans, chats and revenue and drafts replies.
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.
Is it safe for a creator to link their Fansly account?
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.