Skip to content

Platforms

One API for OnlyFans, Fansly and Fanvue

Every creator account lives on one platform. The same routes, keys, MCP tools and webhooks serve every platform, and anything a platform lacks answers not_supported_on_platform. The tables below come straight from the API contract, so they change when the API does.

  • OnlyFans

    Chats, fans, spend, revenue, posts, tracking links and the vault, plus mass messages, paid messages, online fans and webhooks for every new message, sale and subscriber.

    OnlyFans API features
  • Fansly

    Fans, chats, revenue, posts, tracking links and the vault on the same routes, with the same keys. Send free messages and take them back.

    The Fansly API
  • Fanvue

    Fans, chats, revenue, posts, tracking links and the vault on the same routes, read live from Fanvue. Send free, paid and mass messages. In Beta.

    The Fanvue API

Differences

What only one platform has

A route or write here answers not_supported_on_platform for an account on another platform, and a webhook event here is never sent for one. A few more work on two of the three, such as mass messages and message search: the tables below mark each one.

OnlyFans only

REST routes
Call OnlyFans

Fansly only

REST routes
Call Fansly
Rules
A message is free, goes to a chat the account already has and attaches free vault media only. New messages and sales usually arrive within a minute. More on the Fansly API

Fanvue only

REST routes
Call Fanvue
Webhook events
fanvue.*
Rules
Every read asks Fanvue live and counts as a live call. A paid message carries media and costs at least $3, and a mass message goes to fan lists. More on the Fanvue API

Route by route

What works on each platform

Read from the API contract. Each name links to its reference in the docs.

REST routes

Every route an API key can call. Routes that take an account answer with meta.platform.

REST routes on OnlyFans, Fansly and Fanvue
REST routesOnlyFansFanslyFanvue
GET /v1/meWho am IWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accountsList accountsAdd platform=onlyfans, platform=fansly or platform=fanvue to list one platform.Works on OnlyFansWorks on FanslyWorks on Fanvue
POST /v1/linksCreate linkSet platform, or leave it out and the creator picks.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/links/{linkId}Get linkWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}Get accountWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/fansList fansWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/fans/{fanId}Get fanfresh=true reads the fan live on OnlyFans and Fansly, and every Fanvue read is live. On Fansly, message and post purchases count in spend.other.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/listsFan listsWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/chatsList chatsWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/chats/{fanId}/messagesList messagesOn Fansly, fresh=true works for a chat the account already has.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/messages/searchSearch messagesWorks on OnlyFansWorks on FanslyDoes not work on Fanvue
POST /v1/accounts/{accountId}/chats/{fanId}/typingShow typingWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/revenueRevenue summaryWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/transactionsList transactionsOn Fansly, message and post purchases have type other.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/mass-messagesMass messagesWorks on OnlyFansDoes not work on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/postsTop contentTips per post are set on Fansly and null on OnlyFans.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/linksTracking linksurl is null on Fansly, which does not say the address fans open.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/online-fansOnline fansOn Fansly, since is null and fresh=true checks up to 500 fans.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/vaultVaultWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/accounts/{accountId}/onlyfans/{path}Call OnlyFansWorks on OnlyFansDoes not work on FanslyDoes not work on Fanvue
GET /v1/accounts/{accountId}/fansly/{path}Call FanslyDoes not work on OnlyFansWorks on FanslyDoes not work on Fanvue
GET /v1/accounts/{accountId}/fanvue/{path}Call FanvueDoes not work on OnlyFansDoes not work on FanslyWorks on Fanvue
POST /v1/accounts/{accountId}/actionsCreate actionFansly takes send_message and unsend_message. Fanvue takes every type.Works on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/actions/{actionId}Get actionWorks on OnlyFansWorks on FanslyWorks on Fanvue
GET /v1/actionsList actionsWorks on OnlyFansWorks on FanslyWorks on Fanvue

Writes

Each write is an action, and it waits for your team's approval by default.

Writes on OnlyFans, Fansly and Fanvue
WritesOnlyFansFanslyFanvue
send_messageSend messageOn Fansly it is free, goes to a chat the account already has and attaches free vault media only. On Fanvue a paid message needs media.Works on OnlyFansWorks on FanslyWorks on Fanvue
send_mass_messageSend mass messageOn Fanvue it goes to lists, never to single fans.Works on OnlyFansDoes not work on FanslyWorks on Fanvue
unsend_messageUnsend messageOn OnlyFans and Fanvue it can take back every copy of a mass message.Works on OnlyFansWorks on FanslyWorks on Fanvue
add_fan_to_listAdd fan to listWorks on OnlyFansDoes not work on FanslyWorks on Fanvue
remove_fan_from_listRemove fan from listWorks on OnlyFansDoes not work on FanslyWorks on Fanvue

Webhook events

Every event that names an account carries account.platform, and its data has the same shapes as the API.

Webhook events on OnlyFans, Fansly and Fanvue
Webhook eventsOnlyFansFanslyFanvue
account.connectedA creator account was linked to the workspace.Works on OnlyFansWorks on FanslyWorks on Fanvue
account.status_changedAn account's status changed, for example to Needs relink.Works on OnlyFansWorks on FanslyWorks on Fanvue
account.removedAn account was removed from the workspace.Works on OnlyFansWorks on FanslyWorks on Fanvue
link.failedA hosted link session ended without connecting.Works on OnlyFansWorks on FanslyWorks on Fanvue
message.receivedA fan sent a message.Works on OnlyFansWorks on FanslyWorks on Fanvue
message.sentThe account sent a message to a fan.Works on OnlyFansWorks on FanslyWorks on Fanvue
message.unsentA message was unsent.Works on OnlyFansWorks on FanslyWorks on Fanvue
message.likedA message was liked.Works on OnlyFansDoes not work on FanslyDoes not work on Fanvue
message.unlikedA like was taken off a message.Works on OnlyFansDoes not work on FanslyDoes not work on Fanvue
message.purchasedA fan bought a paid message.Works on OnlyFansDoes not work on FanslyWorks on Fanvue
transaction.createdA fan paid for something: a subscription, tip, message, post or stream.Works on OnlyFansWorks on FanslyWorks on Fanvue
subscriber.newA fan subscribed or resubscribed.Works on OnlyFansWorks on FanslyWorks on Fanvue
fan.onlineA subscribed fan came online.Works on OnlyFansDoes not work on FanslyDoes not work on Fanvue
fan.typingA fan is typing a message to the account.Works on OnlyFansWorks on FanslyDoes not work on Fanvue
action.pendingAn API client asked for a write that needs approval.Works on OnlyFansWorks on FanslyWorks on Fanvue
action.executedAn approved write ran on the account.Works on OnlyFansWorks on FanslyWorks on Fanvue
action.rejectedA person rejected a pending write.Works on OnlyFansWorks on FanslyWorks on Fanvue
action.failedAn approved write failed on the platform.Works on OnlyFansWorks on FanslyWorks on Fanvue
fanvue.payment.succeededFanvue: a payment settled (subscription, tip, paid message, post or media).Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.reward.createdFanvue: a referral reward was earned.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.reward.reversedFanvue: a referral reward was taken back.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.refund.createdFanvue: a payment was refunded.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.dispute.flaggedFanvue: a payment was flagged for a dispute.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.dispute.createdFanvue: a fan disputed a payment.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.subscription.activatedFanvue: a fan subscribed, or subscribed again.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.subscription.renewedFanvue: a subscription renewed.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.subscription.deactivatedFanvue: a subscription ended.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.subscription.cancel_at_period_end_changedFanvue: a fan turned auto-renew off or back on.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.receivedFanvue: a fan sent a message.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.sentFanvue: the account sent a message to one fan.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.mass_sentFanvue: the account sent a mass message. One notice per send, not per fan.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.readFanvue: the account read a fan's messages.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.read_by_fanFanvue: a fan read the account's messages.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.deletedFanvue: a message was unsent.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.message.reactionFanvue: someone reacted to a message.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.chat.marked_unreadFanvue: a chat was marked unread.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.follow.createdFanvue: someone followed the account.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.post.likedFanvue: someone liked a post.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.post.commentedFanvue: someone commented on a post.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.fan.status_changedFanvue: a fan's status with the account changed.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue
fanvue.fan.presence_changedFanvue: a fan came online or went offline.Does not work on OnlyFansDoes not work on FanslyWorks on Fanvue

MCP tools

One tool set serves every platform. The account decides which platform a call reaches.

MCP tools on OnlyFans, Fansly and Fanvue
MCP toolsOnlyFansFanslyFanvue
list_accountsList accountsWorks on OnlyFansWorks on FanslyWorks on Fanvue
account_healthAccount healthWorks on OnlyFansWorks on FanslyWorks on Fanvue
link_accountLink an accountWorks on OnlyFansWorks on FanslyWorks on Fanvue
get_linkCheck a linkWorks on OnlyFansWorks on FanslyWorks on Fanvue
find_fansFind fansWorks on OnlyFansWorks on FanslyWorks on Fanvue
get_fanGet fanWorks on OnlyFansWorks on FanslyWorks on Fanvue
list_chatsList chatsWorks on OnlyFansWorks on FanslyWorks on Fanvue
get_chatGet chatWorks on OnlyFansWorks on FanslyWorks on Fanvue
search_messagesSearch messagesWorks on OnlyFansWorks on FanslyDoes not work on Fanvue
revenue_summaryRevenue summaryWorks on OnlyFansWorks on FanslyWorks on Fanvue
list_transactionsList transactionsWorks on OnlyFansWorks on FanslyWorks on Fanvue
mass_message_performanceMass message performanceWorks on OnlyFansDoes not work on FanslyWorks on Fanvue
top_contentTop contentWorks on OnlyFansWorks on FanslyWorks on Fanvue
link_performanceTracking link performanceWorks on OnlyFansWorks on FanslyWorks on Fanvue
online_fansOnline fansWorks on OnlyFansWorks on FanslyWorks on Fanvue
list_vaultList vaultWorks on OnlyFansWorks on FanslyWorks on Fanvue
search_apiSearch the platform APIWorks on OnlyFansWorks on FanslyWorks on Fanvue
describe_endpointDescribe a platform endpointWorks on OnlyFansWorks on FanslyWorks on Fanvue
call_apiCall the platform APIWorks on OnlyFansWorks on FanslyWorks on Fanvue
search_docsSearch docsWorks on OnlyFansWorks on FanslyWorks on Fanvue
get_docGet docWorks on OnlyFansWorks on FanslyWorks on Fanvue
draft_messageDraft a messageWorks on OnlyFansWorks on FanslyWorks on Fanvue
send_messageSend messageWorks on OnlyFansWorks on FanslyWorks on Fanvue
send_mass_messageSend mass messageWorks on OnlyFansDoes not work on FanslyWorks on Fanvue
unsend_messageUnsend messageWorks on OnlyFansWorks on FanslyWorks on Fanvue
list_fan_listsList fan listsWorks on OnlyFansWorks on FanslyWorks on Fanvue
label_fanAdd or remove a fan from a listWorks on OnlyFansDoes not work on FanslyWorks on Fanvue
get_actionGet actionWorks on OnlyFansWorks on FanslyWorks on Fanvue

Linking

How creators connect each platform

Creators can link their own accounts on a page we host. Here is what each platform asks them for.

How a creator links an OnlyFans, Fansly or Fanvue account
LinkingOnlyFansFanslyFanvue
Signs in withAccount email and passwordUsername or email, and passwordFanvue's own sign-in page. BetterFans Link never sees the password
Two-factor codeFrom an authenticator app, a text message or emailBy email or from an authenticator appOnly if Fanvue asks for one, on its own page
Human checkSometimesNeverNever on the link page
Selfie checkSometimesNeverNever
StatusesAll seven, including Awaiting selfie and Restricted by OnlyFansFive. Never Awaiting selfie or RestrictedThree: Healthy, Needs relink and Disconnected
WorkspacesAny number, each with its own accessOne at a time. A second link fails with account_in_useOne at a time. A second link fails with account_in_use
Sandbox creatorsIvy, Juniper and WrenSloaneMarlo

Link a creator

One workspace

Write it once for every platform

A key reaches every account in its workspace, on any platform. Branch on platform only where the platforms differ, and keep every id a string.

every-platform.ts
const BFL = "https://betterfans.link/v1";
const headers = { Authorization: `Bearer ${process.env.BFL_KEY}` };

// One key reaches every account in the workspace, on any platform
const { data: accounts } = await fetch(`${BFL}/accounts`, { headers }).then((r) => r.json());

for (const account of accounts) {
  // Same route everywhere. Ids are strings: Fansly ids do not fit in a number, Fanvue ids are UUIDs.
  const { data: fans, meta } = await fetch(
    `${BFL}/accounts/${account.id}/fans?sort=spend&limit=5`,
    { headers },
  ).then((r) => r.json());

  console.log(meta.platform, account.username, fans.length);

  if (account.platform !== "fansly") {
    // Mass messages exist on OnlyFans and Fanvue
  }
}

FAQ

OnlyFans, Fansly and Fanvue API questions

Can one workspace hold OnlyFans, Fansly and Fanvue creators?

Yes. A workspace can link creators on every platform, and GET /v1/accounts lists them together with each one's platform. Add platform=onlyfans, platform=fansly or platform=fanvue to list one platform. Roles, approvals, the request log and the audit log cover every account the same way.

What happens if I call an OnlyFans only route for a Fansly account?

The API answers 400 not_supported_on_platform and does nothing. The same goes for a write type the platform does not take: a mass message for a Fansly account is refused when you create it, before any action exists. Each route in the docs lists the platforms it works for.

Do OnlyFans, Fansly and Fanvue return the same data shapes?

Yes. A fan, chat, message, transaction, post, tracking link or vault item has the same fields on every platform. A field is null where a platform does not say it, such as the address of a Fansly tracking link or the tips on an OnlyFans post.

How do I tell which platform an account is on?

Every account has a platform field, onlyfans, fansly or fanvue. Every response for one account repeats it in meta.platform, and every webhook event that names an account carries account.platform, so you can branch on it anywhere.

GET STARTED

Build it in test mode today.

Sign up, make a test key and build against sandbox creators on every platform. Link real accounts when your flow is ready.

Questions first? Write to hello@betterfans.link.