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 featuresFansly
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 APIFanvue
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- Webhook events
message.likedmessage.unlikedfan.online
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 | OnlyFans | Fansly | Fanvue |
|---|---|---|---|
GET /Who am I | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List accountsAdd platform=onlyfans, platform=fansly or platform=fanvue to list one platform. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
POST /Create linkSet platform, or leave it out and the creator picks. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Get link | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Get account | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List fans | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /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 OnlyFans | Works on Fansly | Works on Fanvue |
GET /Fan lists | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List chats | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List messagesOn Fansly, fresh=true works for a chat the account already has. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Search messages | Works on OnlyFans | Works on Fansly | Does not work on Fanvue |
POST /Show typing | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Revenue summary | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List transactionsOn Fansly, message and post purchases have type other. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Mass messages | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
GET /Top contentTips per post are set on Fansly and null on OnlyFans. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Tracking linksurl is null on Fansly, which does not say the address fans open. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Online fansOn Fansly, since is null and fresh=true checks up to 500 fans. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Vault | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Call OnlyFans | Works on OnlyFans | Does not work on Fansly | Does not work on Fanvue |
GET /Call Fansly | Does not work on OnlyFans | Works on Fansly | Does not work on Fanvue |
GET /Call Fanvue | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
POST /Create actionFansly takes send_message and unsend_message. Fanvue takes every type. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /Get action | Works on OnlyFans | Works on Fansly | Works on Fanvue |
GET /List actions | Works on OnlyFans | Works on Fansly | Works on Fanvue |
Writes
Each write is an action, and it waits for your team's approval by default.
| Writes | OnlyFans | Fansly | Fanvue |
|---|---|---|---|
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 OnlyFans | Works on Fansly | Works on Fanvue |
send_mass_messageSend mass messageOn Fanvue it goes to lists, never to single fans. | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
unsend_messageUnsend messageOn OnlyFans and Fanvue it can take back every copy of a mass message. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
add_fan_to_listAdd fan to list | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
remove_fan_from_listRemove fan from list | Works on OnlyFans | Does not work on Fansly | Works 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 | OnlyFans | Fansly | Fanvue |
|---|---|---|---|
account.connectedA creator account was linked to the workspace. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
account.status_changedAn account's status changed, for example to Needs relink. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
account.removedAn account was removed from the workspace. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
link.failedA hosted link session ended without connecting. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
message.receivedA fan sent a message. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
message.sentThe account sent a message to a fan. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
message.unsentA message was unsent. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
message.likedA message was liked. | Works on OnlyFans | Does not work on Fansly | Does not work on Fanvue |
message.unlikedA like was taken off a message. | Works on OnlyFans | Does not work on Fansly | Does not work on Fanvue |
message.purchasedA fan bought a paid message. | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
transaction.createdA fan paid for something: a subscription, tip, message, post or stream. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
subscriber.newA fan subscribed or resubscribed. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
fan.onlineA subscribed fan came online. | Works on OnlyFans | Does not work on Fansly | Does not work on Fanvue |
fan.typingA fan is typing a message to the account. | Works on OnlyFans | Works on Fansly | Does not work on Fanvue |
action.pendingAn API client asked for a write that needs approval. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
action.executedAn approved write ran on the account. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
action.rejectedA person rejected a pending write. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
action.failedAn approved write failed on the platform. | Works on OnlyFans | Works on Fansly | Works on Fanvue |
fanvue.payment.succeededFanvue: a payment settled (subscription, tip, paid message, post or media). | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.reward.createdFanvue: a referral reward was earned. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.reward.reversedFanvue: a referral reward was taken back. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.refund.createdFanvue: a payment was refunded. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.dispute.flaggedFanvue: a payment was flagged for a dispute. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.dispute.createdFanvue: a fan disputed a payment. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.subscription.activatedFanvue: a fan subscribed, or subscribed again. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.subscription.renewedFanvue: a subscription renewed. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.subscription.deactivatedFanvue: a subscription ended. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.subscription.cancel_at_period_end_changedFanvue: a fan turned auto-renew off or back on. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.receivedFanvue: a fan sent a message. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.sentFanvue: the account sent a message to one fan. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.mass_sentFanvue: the account sent a mass message. One notice per send, not per fan. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.readFanvue: the account read a fan's messages. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.read_by_fanFanvue: a fan read the account's messages. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.deletedFanvue: a message was unsent. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.message.reactionFanvue: someone reacted to a message. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.chat.marked_unreadFanvue: a chat was marked unread. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.follow.createdFanvue: someone followed the account. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.post.likedFanvue: someone liked a post. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.post.commentedFanvue: someone commented on a post. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.fan.status_changedFanvue: a fan's status with the account changed. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
fanvue.fan.presence_changedFanvue: a fan came online or went offline. | Does not work on OnlyFans | Does not work on Fansly | Works on Fanvue |
MCP tools
One tool set serves every platform. The account decides which platform a call reaches.
| MCP tools | OnlyFans | Fansly | Fanvue |
|---|---|---|---|
list_accountsList accounts | Works on OnlyFans | Works on Fansly | Works on Fanvue |
account_healthAccount health | Works on OnlyFans | Works on Fansly | Works on Fanvue |
link_accountLink an account | Works on OnlyFans | Works on Fansly | Works on Fanvue |
get_linkCheck a link | Works on OnlyFans | Works on Fansly | Works on Fanvue |
find_fansFind fans | Works on OnlyFans | Works on Fansly | Works on Fanvue |
get_fanGet fan | Works on OnlyFans | Works on Fansly | Works on Fanvue |
list_chatsList chats | Works on OnlyFans | Works on Fansly | Works on Fanvue |
get_chatGet chat | Works on OnlyFans | Works on Fansly | Works on Fanvue |
search_messagesSearch messages | Works on OnlyFans | Works on Fansly | Does not work on Fanvue |
revenue_summaryRevenue summary | Works on OnlyFans | Works on Fansly | Works on Fanvue |
list_transactionsList transactions | Works on OnlyFans | Works on Fansly | Works on Fanvue |
mass_message_performanceMass message performance | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
top_contentTop content | Works on OnlyFans | Works on Fansly | Works on Fanvue |
link_performanceTracking link performance | Works on OnlyFans | Works on Fansly | Works on Fanvue |
online_fansOnline fans | Works on OnlyFans | Works on Fansly | Works on Fanvue |
list_vaultList vault | Works on OnlyFans | Works on Fansly | Works on Fanvue |
search_apiSearch the platform API | Works on OnlyFans | Works on Fansly | Works on Fanvue |
describe_endpointDescribe a platform endpoint | Works on OnlyFans | Works on Fansly | Works on Fanvue |
call_apiCall the platform API | Works on OnlyFans | Works on Fansly | Works on Fanvue |
search_docsSearch docs | Works on OnlyFans | Works on Fansly | Works on Fanvue |
get_docGet doc | Works on OnlyFans | Works on Fansly | Works on Fanvue |
draft_messageDraft a message | Works on OnlyFans | Works on Fansly | Works on Fanvue |
send_messageSend message | Works on OnlyFans | Works on Fansly | Works on Fanvue |
send_mass_messageSend mass message | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
unsend_messageUnsend message | Works on OnlyFans | Works on Fansly | Works on Fanvue |
list_fan_listsList fan lists | Works on OnlyFans | Works on Fansly | Works on Fanvue |
label_fanAdd or remove a fan from a list | Works on OnlyFans | Does not work on Fansly | Works on Fanvue |
get_actionGet action | Works on OnlyFans | Works on Fansly | Works 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.
| Linking | OnlyFans | Fansly | Fanvue |
|---|---|---|---|
| Signs in with | Account email and password | Username or email, and password | Fanvue's own sign-in page. BetterFans Link never sees the password |
| Two-factor code | From an authenticator app, a text message or email | By email or from an authenticator app | Only if Fanvue asks for one, on its own page |
| Human check | Sometimes | Never | Never on the link page |
| Selfie check | Sometimes | Never | Never |
| Statuses | All seven, including Awaiting selfie and Restricted by OnlyFans | Five. Never Awaiting selfie or Restricted | Three: Healthy, Needs relink and Disconnected |
| Workspaces | Any number, each with its own access | One at a time. A second link fails with account_in_use | One at a time. A second link fails with account_in_use |
| Sandbox creators | Ivy, Juniper and Wren | Sloane | Marlo |
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.
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.