Documentation
One API for OnlyFans and Fansly.
529 endpoints across a signed OnlyFans passthrough and a normalized, Fansly-aware CRM layer. One API key, two platforms — we handle request signing, sessions, proxies and re-login.
curl "https://theonlyapi.com/api/crm/{crm_id}/accounts" \
-H "X-API-Key: <your 43-char key>"Get started
From zero to a working integration in about five minutes.
Quickstart
Create a panel, connect a creator account, make your first authenticated call.
Get an API key
Where keys live in the dashboard, primary vs secondary keys, and how to rotate one.
Authentication
The X-API-Key header, panel scoping, and what a 403 actually means.
Base URL & panels
Why every path carries a crm_id, and the seven routes that don't.
Connect an account
Session paste or credentials, 2FA, and the proxy requirement.
OnlyFans vs Fansly
What each surface supports, and which routes reject Fansly accounts.
Core concepts
The handful of things that explain most surprising responses.
The two surfaces
A thin signed passthrough and a normalized CRM layer, with different response shapes.
Responses & errors
Two envelopes, the real error shapes, and the honeypot _notice wrapper.
Pagination
Three conventions. /chats ignores limit, and a short page is not the end.
Rate limits & quotas
600/120/10 per minute, the monthly call quota, and platform-side pacing.
Async jobs
The 202 + poll pattern behind refresh, backfill and export.
Sessions & re-login
How sessions persist, when we auto-retry, and what relogin_failed means.
Build with realtime
Events flow from our pollers to your infrastructure.
Events
The nine event types, what triggers each, and their payload fields.
Webhooks
HMAC signature verification, the retry ladder, and auto-deactivation.
Server-sent events
Subscribe to a live event stream over GET /events/stream.
Automations
Condition operators, {payload.x.y} templating, and six action types.
Messaging & mass DM
DMs, PPVs, mass sends, and the write-actions gate.
Earnings & transactions
Cross-account aggregation, cached reads, and the money-scale gotcha.
AI & agents
Every page here is machine-readable, and the API itself is an MCP server.
Use these docs with an AI
Copy any page as Markdown, open it in ChatGPT or Claude, or point an agent at our MCP server.
MCP server setup
Connect the API to Claude, ChatGPT, Cursor or Claude Code. 59 tools, OAuth 2.1.
llms.txt
txtAn index of this documentation for AI assistants, plus per-section full-text variants.
API reference
Generated from the OpenAPI 3.1 spec.
CRM API
95 endpointsNormalized OnlyFans + Fansly: accounts, fans, messaging, earnings, subscribers, campaigns, exports, webhooks, automations, events.
OnlyFans passthrough
434 endpointsA signed proxy over /api2/v2. OnlyFans' own response, wrapped in a small envelope.
OpenAPI 3.1 spec
jsonThe machine-readable contract behind this reference.
Interactive playground
Run any endpoint against your own panel from the dashboard.
Reference
Everything else.