Introduction
Welcome to the Fans API documentation!
Fans API is an independent, unofficial service and is not affiliated with or approved by OnlyFans. Use it only on accounts you own or are authorised in writing to manage, and comply with the OnlyFans Terms of Service, including §8(b) (creator responsibility for third-party assistants) and §8(g) (automated data collection and AI training). Label AI-generated content #ai. See Compliance & acceptable use.
Why Fans API?
Fans API is a platform that allows you to interact with the OnlyFans API without the need to build your proxy management system, reverse engineer the API, or deal with WebSockets.
Our engineers have spent years building 350+ simple REST API endpoints that cover everything OnlyFans agencies, creators, and developers need:
- Connect any OnlyFans account in under 2 minutes
- Read and send messages, posts, mass-DMs, and PPVs
- Pull earnings, transactions, fans, and chargebacks
- Manage media vault, queue, stories, and promotions
- Receive real-time webhook events for new messages, subs, tips, and more
- Search a database of 3.5M+ public OnlyFans creator profiles
Popular use cases
What teams build on Fans API today:
Track Meta Ads & media buying revenue
Track links, traffic sources, fans, revenue, spend, ROAS, pixels, postbacks, and pre-landers from one workspace.
Attribute ad revenue with Smart Links
Create tracking or free-trial Smart Links and query their clicks, fans, conversions, and performance.
Build AI chatters and chatbot SaaS
Read live chats, send replies, manage queue, and apply tags — the same surface our partners build chatbot products on.
Run your agency with FansBot AI
Our AI agency assistant in Telegram, Slack, and Discord — chat to manage creators, draft replies, run workflows, and get earnings digests.
Build dashboards, CRMs, and BI
Pull statistics, transactions, and fan analytics into Postgres, BigQuery, or your in-house dashboard.
Run your agency from Claude, ChatGPT, or Manus
350+ tools across chats, fans, and earnings via the OnlyFans MCP — ask in plain English, get reports, drafts, and digests.
Automate without code (n8n, Make, Zapier)
Trigger workflows on new messages, PPV purchases, subs, tips, and more — no engineer required.
Send mass DMs & re-engagement campaigns
Schedule, target, and track mass-message performance across creators.
Browse the docs
Fans API has different areas:
API Reference
Every endpoint, request/response shapes, and SDK snippets.
Webhooks
Get notified about new messages, subs, tips, chargebacks, and more.
Smart Links
Server-side attribution links for Meta, TikTok, and Snapchat media buying.
OnlyFans x AI Tools
Run your agency from Claude, ChatGPT, or Manus via the OnlyFans MCP.
FansBot
Your AI agency assistant in Telegram, Slack, and Discord.
Integrations
No-code automations with n8n, Make, and Zapier.
Data Exports
Bulk export transactions, messages, and more.
Login with OnlyFans
Fans API's official authentication library.
FAQ
Common questions about plans, limits, and account safety.
Get started
Whether you're building a chatbot, OnlyFans Search Engine, OnlyFans CRM, or anything else, you can get started with Fans API in minutes.
Make your first API Request
Learn how to make your first API request and get started with Fans API
Get your API Key
Create your first API Key and start making requests
Connect your OnlyFans accounts
Learn how to connect you OnlyFans accounts in under 2 minutes
Get Webhook Notifications
Get webhook notifications for new messages, new subscribers, tips, ...