Fanvue API · Beta
A Fanvue API for agencies and developers
Fanvue publishes an API for apps, and BetterFans Link connects your creators through it. The Fanvue accounts linked to your workspace answer the same routes, keys, webhooks and MCP tools as your OnlyFans and Fansly accounts, and every read comes live from Fanvue. Fanvue support is in Beta.
# Every Fanvue account your key can use, with its status
curl "https://betterfans.link/v1/accounts?platform=fanvue" \
-H "Authorization: Bearer $BFL_KEY"
# Its biggest spenders, read live from Fanvue. Fanvue ids are UUIDs.
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?sort=spend&limit=10" \
-H "Authorization: Bearer $BFL_KEY"
# Anything else Fanvue shows, from the reviewed list
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fanvue/chats" \
-H "Authorization: Bearer $BFL_KEY"Does Fanvue have an API?
Yes. Fanvue publishes an API for apps, and a creator allows an app on Fanvue's own sign-in page. BetterFans Link is one of those apps. It works only with Fanvue accounts linked to your workspace and gives them the same routes, API keys, webhooks and MCP server as OnlyFans and Fansly. It is not affiliated with or endorsed by Fanvue.
Reads
What you can read on Fanvue
The same routes as OnlyFans and Fansly, with the same keys. Each read asks Fanvue live.
Fans and subscribers
Rank fans by spend or recency, with subscription status and dates, lifetime spend by type, the lists they are on and the creator's note.
Chats and messages
Chats with unread counts and spend, and the messages in each one. Reading a chat never marks it read on Fanvue.
Revenue and transactions
Gross and net for any period from Fanvue's own totals, split by type and as a series, with top fans. Each sale with its fan, gross, net and fee.
Mass messages, posts and links
Mass messages with how many fans got and viewed them, posts with likes, comments and tips, and tracking and free trial links.
The vault
Every photo, video and audio clip by folder and type, with the ids to attach to a message.
Anything else Fanvue shows
Call Fanvue reads any endpoint on the reviewed list, live. Reads only.
Writes
What you can send on Fanvue
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 and paid messages
Send a fan a message with vault media. A paid Fanvue message carries media and costs at least $3.
Mass messages to lists
Send one message to the creator's fan lists, with lists left out if you like. Fanvue mass messages go to lists, not to single fans.
Take messages back
Unsend one message, or every copy of a mass message by its id. Add and remove fans on the creator's custom lists.
Linking
How a Fanvue creator connects
- 01
Send a link
Make one in the dashboard or with POST /v1/links and platform fanvue. It works for 24 hours.
- 02
Continue to Fanvue
The creator presses Continue to Fanvue and signs in on Fanvue's own page, with their own login.
- 03
Allow BetterFans
Fanvue asks the creator to allow BetterFans. The password stays with Fanvue.
- 04
Connected
Fanvue sends the creator back, the account joins your workspace and account.connected fires.
A Fanvue account can be connected to one workspace at a time. Its status is Healthy, Needs relink or Disconnected. What each status means
Not on Fanvue
What a Fanvue account does not take
A route here answers not_supported_on_platform for a Fanvue account, before anything happens. A webhook event here is never sent for one.
- REST routes
Search messagesCall OnlyFansCall Fansly- Webhook events
message.likedmessage.unlikedfan.onlinefan.typing
Features
Fanvue API features
Fanvue messaging
Read Fanvue chats live, and send free, paid and mass messages.
Fanvue earnings
Fanvue revenue by type and period, every transaction, and the tips each post earned.
Fanvue fan data
Rank Fanvue subscribers by spend, with subscription dates, spend by type, notes and lists.
Fanvue agencies
Link many Fanvue creators to one workspace, with roles, per-account keys and a log of every call.
Fanvue MCP server
Connect Claude or Cursor to your Fanvue creators. It reads fans, chats and revenue and drafts replies.
FAQ
Fanvue API questions
How fresh is Fanvue data?
Every read of a Fanvue account asks Fanvue at that moment, so the answer is as fresh as Fanvue itself. BetterFans Link keeps no copy of a Fanvue account, so each read counts as a live call on your plan.
Can I send paid and mass messages on Fanvue?
Yes. A paid Fanvue message carries vault media and costs at least $3, and a mass message goes to the creator's fan lists. Each one is an action with a plain summary in the dashboard, and AI clients that sign in with OAuth wait for your team to approve it.
Can a team member connect a creator's Fanvue account?
Not yet. The creator signs in to Fanvue with their own login on the link page. A Fanvue team member login ends the link with not_creator_account, so send the link to the creator.
Can I try the Fanvue API without a Fanvue account?
Yes. Test mode has Marlo, a sandbox creator on Fanvue with sample fans, chats and revenue, next to the OnlyFans and Fansly sandbox creators. Use a bfl_test_ key to build against Marlo, and test sends record a simulated result without reaching Fanvue.
GET STARTED
Build it in test mode today.
Sign up, make a test key and build against Marlo, the Fanvue sandbox creator. Link a real Fanvue account when your flow is ready.
Questions first? Write to hello@betterfans.link.