Skip to content

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.

fanvue.sh
# 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

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.

Every platform, route by route

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.