Skip to content

onlyfansapi/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

OnlyFansAPI

OnlyFansAPI — The OnlyFans API for Developers, Agencies & Traffic Buyers

200+ endpoints · 99.98% uptime · 5+ years live, 0 accounts banned. Build CRMs, chatbots, mass-messaging tools, Smart Links, and AI agents on top of OnlyFans.

Website Docs Status Telegram

Trusted by 2,000+ developers · 100+ platforms · 10,000+ connected OnlyFans accounts


The OnlyFans API engineered for production

OnlyFansAPI is the infrastructure layer beneath the next generation of OnlyFans software — CRMs, AI chatbots, mass-messaging platforms, conversion tracking tools, Meta Ads attribution stacks, and analytics dashboards.

We handle the parts you don't want to: authentication (including 2FA and Face Verification), dedicated proxy infrastructure, account safety, real-time events, scale, reliability, and continuous updates as OnlyFans evolves — months of engineering that ship zero customer-facing features. You build product.

OnlyFans does not offer an official public API. OnlyFansAPI is the most complete unofficial OnlyFans API on the market, with 200+ documented endpoints, native no-code integrations (n8n, Make, Zapier), and a 5-year track record of zero account bans.

Core capabilities

  • 🔌 Complete REST API — full coverage across messages, mass messaging, posts, vault, fans, subscriptions, transactions, payouts, chargebacks, statistics, free trial links, tracking links, and more. 200+ endpoints, fully documented, live playground.
  • 🔐 @onlyfansapi/auth — the official NPM authentication package. 1.5 kB, loads in ~2 ms, framework-agnostic, fully typed. Handles email/password, 2FA, and Face Verification flows out of the box.
  • 🤖 OnlyFans MCP server — 246 tools across 46 groups exposed to Claude, ChatGPT, Manus, Cursor, VS Code Copilot, and custom AI agents via the Model Context Protocol. 60-second install. No glue code.
  • 🎯 Smart Links + Meta Pixel integration — server-side OnlyFans conversion tracking that streams subscriptions, rebills, tips, and PPV revenue back to Meta Pixel, TikTok, Snap, Google Ads, and adult-network postbacks. Cut cost-per-sub by 30–50% in 4–5 weeks.
  • 📡 Webhooks + real-time events — HMAC-signed payloads for new messages, sales, renewals, subscribers, and more. Free on every plan.
  • 🧩 Native no-code integrations — community node for n8n, Make app, Zapier app, plus a no-code data export tool and pre-made scenarios.
  • 🛡️ Bank-grade security — AES-256 encryption, isolated systems, secret vaulting, dedicated proxy infrastructure. 5+ years live, 0 accounts banned.
  • Fast and reliable — 300 ms write latency (capped by OnlyFans itself), 99.98% uptime, transparent status page.

Build for these audiences

If you're building... What OnlyFansAPI gives you
An OnlyFans chatbot Real-time webhook events, send-message API, mass DM queueing, MCP server for AI assistants
An OnlyFans CRM Fan management, subscription history, scheduling, statistics, multi-account team support, granular roles
An OnlyFans agency back-office Manage hundreds of creator accounts from one API key, per-creator scopes, role-based dashboard access
A traffic & attribution platform Server-side Smart Links, free trial links, tracking links, cohort ARPS, lifetime revenue attribution
A Meta Ads / paid traffic stack Native Meta Pixel integration, server-side conversion events, postbacks for TrafficStars, TrafficJunky, ExoClick
An AI-powered creator tool MCP server lets your AI agent take action on connected accounts in plain English
An earnings / financial dashboard Transactions, payouts, chargebacks, historical performance, AI Financial Analytics
A creator discovery platform Public profile search, filters, analytics, AI fan summaries

Build the next generation of OnlyFans software

Platform-replacements you can build with OnlyFansAPI include:

  • 🤖 AI chat platforms — Botly, Supercreator, Substy, ChatPersona
  • 📊 Creator CRMs — Infloww, OnlyMonster, CreatorHero, FanFapper
  • 📈 Analytics & metrics — FansMetric, FansIQ, FansMetrics
  • 🎯 Traffic & attribution — CreatorTraffic, FansRevenue, CrakRevenue
  • 🔗 Link-in-bio & deeplinks — Juicy Bio, Hello Butter, Hubite
  • 🔍 Discovery & search — OnlyFinder, FansMetrics, Hubite, JuicySearch
  • 🧠 AI agents — Operate your entire agency using Claude, ChatGPT, Cursor, Manus through the OnlyFans MCP server

🤖 Run your OnlyFans agency from Claude, ChatGPT, or Manus — OnlyFans MCP server

The OnlyFans MCP server exposes 246 tools across 46 groups to any AI client that speaks the Model Context Protocol — chats, fans, mass DMs, posts, vault, statistics, smart links, payouts, the works. Your AI agent runs on the exact same surface area as the production CRMs above.

AI client Status Setup Guide
Claude — Desktop · Web · Code · API ✅ Live 60 sec onlyfansapi.com/mcp/claude
ChatGPT — Pro / Business / Enterprise (Custom GPTs, Agent Mode, Deep Research) ✅ Live 90 sec onlyfansapi.com/mcp/chatgpt
Manus — autonomous scheduled agents ✅ Live 90 sec onlyfansapi.com/mcp/manus
Cursor / VS Code Copilot ✅ Live 60 sec Docs ↗
Custom agent — your own MCP client SDK varies Docs ↗

Ask your AI things like:

"What money did we leave on the table yesterday across all creators?" "Which chatters are actually closing PPVs, and which are just typing?" "Which creators should get more paid traffic this week based on cohort ARPS?" "Send a churn-rescue DM to every fan whose sub expired in the last 7 days."

Safety built in: scoped API keys (read-only or write), per-account permissions (lock a key to one creator), full audit log of every tool call, mandatory 2FA on the dashboard, no media stored on our servers. Free under $5k revenue/account/month.

🎯 Cut OnlyFans Meta Ads spend in half — Smart Links + Meta Pixel

OnlyFans doesn't let Meta, TikTok, Google, or any adult ad network see what happens after the click — so the algorithm optimizes for cheap clicks instead of paying subscribers. OnlyFansAPI Smart Links™ fix this by streaming every subscription, rebill, tip, and PPV purchase server-side back to your ad platforms in real time.

What you get

  • 📉 30–50% lower cost-per-sub — typically inside 4–5 weeks once the pixel has enough conversion volume
  • 💰 Lifetime Revenue Attribution — every dollar a fan spends maps back to the ad creative that brought them in
  • 🧠 Native Meta Pixel integrationSubscribe, Purchase, Rebill, and custom events fired automatically through the Meta Conversions API (CAPI)
  • 📊 Cohort ARPS & payback-time analytics — see which traffic source turns profitable fastest before you scale spend
  • 🛡️ Server-side, unblockable — no JavaScript pixel, no iOS / ATT limits, no ad-blocker drop-off. 99.98% delivery reliability.
  • 💸 Per-link promo cost tracking — set CPM / CPC / flat acquisition cost per link to compute true net ROAS

Ad platforms & networks supported

Smart Links push conversion events natively to Meta and TikTok, and emit server-side postbacks that every major adult ad network accepts:

Mainstream Adult ad networks (via postback)
Meta Ads (Facebook + Instagram via Meta Pixel + CAPI) TrafficStars
TikTok Ads (Events API) TrafficJunky
Snapchat Ads (CAPI) ExoClick
Google Ads (Enhanced Conversions) CrakRevenue, JuicyAds, EroAdvertising, and any S2S postback URL
Reddit Ads, X Ads, YouTube Plus link-in-bio: Linktree, Beacons, Hello Butter, Juicy Bio

How it works

  1. Create a Smart Link for a creator, campaign, or single ad creative
  2. Drive traffic from Meta / TikTok / TrafficStars / TrafficJunky / ExoClick / anywhere
  3. Clicks are bound to fans server-side and tracked for life
  4. Revenue + events stream back to Meta Pixel, CAPI, and your ad-network postback URLs — automatically, forever

Full breakdown: onlyfansapi.com/onlyfans-meta-ads

Why OnlyFansAPI vs. DIY scrapers or competitors

Feature OnlyFansAPI DIY scrapers Other unofficial APIs
Complete login flow (2FA + Face Verification)
Official NPM auth module (@onlyfansapi/auth)
No-code automations (native n8n node + Make + Zapier)
API coverage 200+ endpoints, full Partial Partial
Free Trial & Tracking Link revenue attribution 99.9% accuracy
Webhooks + real-time events Partial
MCP server for Claude / ChatGPT / Manus
Meta Pixel + CAPI integration for OnlyFans
Dedicated proxy infrastructure Shared
Uptime / latency 99.98% · 300 ms writes Unknown Unknown
Security track record 5+ years, 0 bans High risk Very high risk
Team management (members + roles)
Support Telegram · Email · WhatsApp · Dedicated channels None Partial

See full comparisons: vs oFansAPI · vs FansMetric · vs Infloww · vs OnlyMonster

What developers and agency founders say

"OnlyFansAPI made building our search engine a smooth and easy process. The tool is simple to navigate, pricing is fair, and the support is great." — Shane Carroll Francis, Founder, Juicy Bio

"Integrating OFAPI was a game-changer — it cut our development time from 6 months down to just one week." — Nicolai L., Founder, Hello Butter

"They built a bespoke, real-time dashboard tailored to our agency. White glove from start to finish." — Andrew E., CFO, 8-figure OFM agency

Quickstart — your first OnlyFans API call

# 1. Sign up — free, no credit card required
open https://app.onlyfansapi.com/register

# 2. Grab your API key from the dashboard, then authenticate an account
curl -X POST https://app.onlyfansapi.com/api/authenticate \
  -H "Authorization: Bearer sk_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"email":"creator@example.com","password":"..."}'

Full quickstart (60 seconds to your first webhook): docs.onlyfansapi.com/introduction/quickstart

🔐 OnlyFans authentication, solved — @onlyfansapi/auth

Connecting an OnlyFans account is the hardest part of every integration: email + password, 2FA codes, Face Verification challenges, and session-cookie handling. The official @onlyfansapi/auth NPM package wraps all of it in a single function call.

npm install @onlyfansapi/auth
import { startOnlyFansAuthentication } from "@onlyfansapi/auth";

startOnlyFansAuthentication("ofapi_cs_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", {
  onSuccess: ({ accountId, username, response }) => {
    // Account connected — accountId is now usable across every OnlyFansAPI endpoint
  },
  onError: ({ message, code, details }) => {
    // Handle 2FA failure, blocked region, bad credentials, etc.
  },
});
  • 1.5 kB — loads in ~2 ms on 4G
  • Framework-agnostic — drop-in for React, Vue, Svelte, Angular, or VanillaJS
  • Full TypeScript support — typed responses, typed errors
  • Handles 2FA + Face Verification end to end
  • 4.9 stars · 1,000+ developers already shipping with it

Full docs: onlyfansapi.com/auth · NPM: @onlyfansapi/auth

Pricing

Free to start. No credit card required. The OnlyFans MCP server, webhooks, and core API are free under $5,000 revenue per connected account per month — you only pay once your creators are making real money.

See pricing · Start free

Trust & safety

  • 🔒 AES-256 encryption at rest for every OnlyFans session credential
  • 🛡️ Dedicated proxy infrastructure per account — no shared IPs, no cross-tenant leakage
  • 🛂 5+ years live, 0 accounts banned across thousands of agencies and 10,000+ connected creators
  • 🚫 Strict secrets boundary — credentials are never logged, never returned by any API, never displayed
  • 🔐 HMAC-signed webhooks with replay-window protection
  • 👤 2FA on the dashboard — mandatory for write-scoped API keys
  • 📋 Full audit log of every API call and MCP tool call
  • 🧾 No media stored — photos, videos, and voice notes never persist on our servers

Security details: docs.onlyfansapi.com/faq#security--safety

Resources

Resource Link
🌐 Website onlyfansapi.com
📚 Documentation docs.onlyfansapi.com
🎮 Live API playground app.onlyfansapi.com/playground
📊 Status & uptime status.onlyfansapi.com
📝 Blog onlyfansapi.com/blog
🎥 Tutorials YouTube @onlyfansapi
🗺️ Roadmap & changelog feedback.onlyfansapi.com
💬 Telegram support t.me/onlyfansapi
📣 Telegram updates t.me/onlyfansapi_updates
🐦 X / Twitter @onlyfansapi
📧 General hello@onlyfansapi.com

Looking for the Fansly API instead? We run that one too.


OnlyFansAPI is an independent organisation and is not affiliated with OnlyFans.com or Fenix International Limited. "OnlyFans" is a registered trademark of Fenix International Limited. "Meta", "Facebook", "Instagram", and the Meta Pixel are trademarks of Meta Platforms, Inc. "TikTok" is a trademark of ByteDance Ltd. "TrafficStars", "TrafficJunky", and "ExoClick" are trademarks of their respective owners. All other trademarks are the property of their respective owners and are referenced for descriptive purposes only.

About

Github Organization Profile

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors