Skip to content
Fans API logo, the company behind the Fansly API

Fans API · APIs and developer tools

Fansly API: Chats, Fans, Earnings and Links

TL;DR

  • This Fansly API is the Fansly side of Fans API. One API key reads and sends chats, lists subscribers and tiers, pulls earnings and reports on tracking links for connected Fansly creators.
  • It runs on the same plans and credits as the OnlyFans side, from a free plan to $69 and $299 a month, with every account priced the same.
  • Skip it if your creators are only on OnlyFans, or if you need a finished app rather than endpoints to build on.
Price
Fans API plans: free, $69 or $299/mo
Product
Fans API
Platforms
Fansly creator accounts, over REST, webhooks and MCP
Free trial
Free plan with 1 account and 100 welcome credits

What the Fansly API is

The Fansly API from Fans API lets your code work with the Fansly accounts of your creators. One Fans API key gives you chats, messages, fans, tiers, posts, the media vault, earnings and tracking links. It is the Fansly twin of the API for OnlyFans, and it is built to work the same way.

Agencies use it to bring Fansly into the tools they already run: a shared team inbox, a CRM that holds fan context, or a revenue report that puts Fansly next to OnlyFans. Account IDs start with fansly_acct_, so you can’t mix them up with OnlyFans accounts. The same endpoints are also exposed as MCP tools, so an AI assistant can work with Fansly data without custom code. It sits in our APIs and developer tools category next to the Fanvue and OnlyFans integrations.

Key features

The Fansly reference groups its endpoints by job. Here is what each group covers, and where it helps an agency.

Chats and mass messaging

You can list chats, read message history, send replies and mark chats as read. Mass messaging covers sending, scheduling, editing and cancelling a scheduled message. A team inbox or a reviewed-reply workflow needs exactly these calls.

Subscribers, tiers and top supporters

List Subscribers and List Subscription Tiers return tier, price, billing cycle and lifecycle timestamps. Top supporter endpoints break down who spends the most and how that changes by month. With them, you can group fans, such as those who turned off renewal, and set your own follow-up rules.

Earnings and payouts

Endpoints cover earnings stats, pending earnings, monthly earnings, wallets, wallet transactions and payout requests. So a finance or reporting tool gets its numbers without anyone copying them by hand.

List Tracking Links returns clicks, claims, follows, subscriptions and revenue totals for each link. The stats endpoints add daily engagement and daily gross and net revenue for a date range, so you can compare Instagram, X and other sources side by side.

Fansly webhooks

Fansly events start with fansly. and arrive through a websocket relay, not polling. They include incoming messages, new and renewed subscriptions, subscription expiry and media purchases. Fansly also adds events OnlyFans doesn’t have, such as reactions, read receipts, post comments, payouts and wallet balances. The Fansly webhook events page lists every event with an example payload. The OnlyFans webhooks page covers the general setup.

MCP tools for AI assistants

Every documented Fansly endpoint is also a tool on the existing Fans API MCP server, named with a fansly_ prefix, such as fansly_listChats. There is no second server or second key. The Fansly over MCP guide shows how Claude, ChatGPT or Manus can even connect an account themselves.

A real request from the Fansly API documentation

This request lists the chats of one connected Fansly account. The path matches the List Chats page in the Fansly API reference. Requests go to app.onlyfansapi.com, the platform’s original domain, with your key as a bearer token.

curl -X GET "https://app.onlyfansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/chats" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Replace the account ID with the fansly_acct_ ID you received when the creator connected, and YOUR_API_KEY with a key from the dashboard. To get the tracking link report instead, call GET /api/fansly/{fanslyAccount}/tracking-links with the same headers.

Three details tend to trip up developers coming from OnlyFans. Fansly money values are in thousandths of a dollar, so 15000 means $15.00. IDs are snowflake strings, which you should keep as strings, because they exceed the safe integer range in JavaScript. And timestamps are in seconds on some fields and milliseconds on others, so check the magnitude before parsing.

Is the Fansly API safe to use?

It works through the creator’s own Fansly account. The creator connects it with their username or email and password. If Fansly asks for verification, the creator submits an emailed or authenticator code. Fans API then holds the session, and you only ever handle your API key and the fansly_acct_ ID.

Treat that API key like a password. Keys aren’t scoped, so any key can call every endpoint for every account connected to your team. Create one key per integration and rotate any key you hand to an outside developer. When an account is disconnected, every request for its ID returns a 404 and the ID is never reused. We know of no independent security audit or certification for the Fansly side, so judge it on the setup described here.

Pricing

Fansly accounts use the normal Fans API plans, and each account costs the same whichever platform it’s on. The free plan covers 1 account and 100 welcome credits for testing. Basic costs $69 a month for 1 account and 20,000 monthly credits. Pro costs $299 a month for 5 accounts and 100,000 monthly credits, with extra accounts at $29 each and discounts at scale. Enterprise is quoted on request. See Fans API pricing for the current plan details.

Plan Price Accounts included Monthly credits
Free $0 1 100 welcome credits
Basic $69/month 1 20,000
Pro $299/month 5 100,000
Enterprise On request Custom Custom

Most uncached requests cost 1 credit, and cached responses cost nothing. Webhooks cost 1 credit per 100 events. Fansly media downloads cost 0 credits, because the endpoint redirects to the file instead of streaming it, so your HTTP client must follow redirects.

Who it’s for, and who should skip it

API for Fansly is for agencies and developers who manage Fansly creators and want that data inside their own systems. It suits teams that already use Fans API for OnlyFans and want Fansly on the same key and bill. It also suits tool builders who need one integration for several platforms, together with the API for Fanvue. If you prefer typed clients, check the SDKs page for language support.

Skip it if your creators are only on OnlyFans, because the Fansly side adds nothing for you. Skip it as well if you need a finished CRM rather than endpoints to build on, or if you rely on Smart Links attribution, presence-based automations or chat queue events. None of those exist for Fansly yet.

Pros and cons

Pros

  • Same API key, credit balance and plan as your OnlyFans and Fanvue accounts
  • Covers chats, mass messages, posts, vault, subscribers, top supporters, earnings and tracking links
  • Fansly webhooks for messages, subscriptions, expiries and media purchases, delivered in near real time
  • Every documented Fansly endpoint is also an MCP tool for Claude, ChatGPT and Manus
  • Fansly media downloads cost 0 credits, because the endpoint redirects instead of streaming

Cons

  • The Fansly reference has about 89 endpoint pages, far fewer than the OnlyFans side
  • No fan presence events and no chat queue events, so "fan came online" automations need polling
  • Smart Links, the attribution add-on, supports OnlyFans and Fanvue creators but not Fansly
  • Fansly's own data formats need care, with money in thousandths of a dollar, snowflake IDs and mixed timestamp units

Frequently Asked Questions

Short answers to the questions agencies ask most.

Is API for Fansly made by Fansly?

No. It's built by Fans API, not by Fansly. Fans API connects a creator's Fansly account and exposes its data through documented REST endpoints, webhooks and MCP tools. You authenticate with your Fans API key, not a key from Fansly. The creator connects their account once, from the dashboard or through the authentication endpoints, and you then call endpoints with the returned fansly_acct_ ID.

Where is the Fansly API documentation?

The reference lives at docs.fansapi.com under API reference, then Fansly. It groups endpoints by accounts, messages, posts, fans, media, tracking links, plans and promos, earnings, statistics and users. Each page shows the method, path, parameters and an example response. Fansly webhook events have their own page in the webhooks section, and the MCP section lists the matching fansly_ tool names.

Do I need a separate API key or plan for Fansly?

No. Fansly requests use the same Fans API key and the same credit balance as your OnlyFans and Fanvue accounts. A Fansly account costs the same as any other account on your plan, and the scale discounts apply equally. Credit use depends on the endpoint, so check its page before you schedule frequent syncs.

How do I connect a Fansly creator account?

Start authentication with the creator's Fansly username or email and password, either from the Fans API dashboard or through the Start Authentication endpoint. If Fansly asks for verification, submit the emailed or authenticator code, then poll the status until the account is connected. The response gives you a fansly_acct_ ID for all later requests. If the creator disconnects and reconnects, they get a new ID.

Can I compare traffic sources for a Fansly creator?

Yes. List Tracking Links returns each link with clicks, claims, follows, subscriptions and revenue totals. Get Tracking Link Stats adds daily engagement, and Get Tracking Link Revenue Stats adds daily gross and net revenue over a date range. That is enough to build a source report in your own dashboard. It is not the same as Smart Links, which doesn't support Fansly.

Verdict

API for Fansly is the right pick if your agency runs Fansly creators next to OnlyFans and wants one integration, one key and one bill for both. It gives a developer the messaging, subscriber, earnings and tracking-link data needed for an inbox, a CRM sync or a revenue report. It is not a finished product, and some OnlyFans conveniences, such as presence events and Smart Links, don't exist on the Fansly side yet.

Best for: Teams that run Fansly accounts next to OnlyFans

Fans API logo

API for Fansly

Fans API plans: free, $69 or $299/mo

Visit Site