OnlyFans API Documentation

Complete reference for all 17+ endpoints. Authentication guides, Python and JavaScript SDKs, code examples, and integration tutorials for agencies and developers.

Getting Started

API key setup, first call, base URL, authentication flow.

Python SDK

Install via pip, code examples, revenue & fan analytics.

JavaScript SDK

Native fetch, async/await, Node.js 18+, TypeScript types.

API Reference

All endpoints, parameters, and response schemas.

Endpoint Reference

All endpoints are prefixed with the base URL http://157.180.79.226:4024/api/v1/onlyfans. Authenticated via the X-API-Key header.

Revenue & Earnings

GET /statistics/overview Full revenue breakdown by category

GET /payouts/transactions Payout transaction history

GET /payouts/balances Current balance and pending amounts

GET /payouts/invoices Invoice and billing records

Fan Intelligence

GET /stats/fans/top Top fans ranked by total spend

GET /stats/fans Fan list with spend and engagement data

GET /stats/reach Audience reach and impression metrics

Subscriber Management

GET /subscribers/top Top subscribers by total value

GET /subscribers/recent Most recently subscribed fans

Messaging

POST /messages/send Send a DM with optional PPV and media

GET /messages/queue Pending message queue status

Content

GET /content/performance Post and content performance metrics

GET /media/stats Media asset analytics and unlock stats

Account

GET /models All creators linked to your account

GET /organizations/models Organization-level model roster

Authentication

All API requests must include your API key in the X-API-Key request header. Keys are issued when you sign up — see Getting Started to generate yours. Never expose keys in client-side code or public repositories.

Terminalcurl
 # Authenticated request example
curl -X GET \
  "http://157.180.79.226:4024/api/v1/onlyfans/models" \
  -H "X-API-Key: your_api_key_here" 

Security note: Store your API key in an environment variable such as OFAPI_KEY. Never commit it to source control.

Rate Limits

Rate limits are enforced per API key. Exceeding the limit returns a 429 Too Many Requests response with a Retry-After header indicating when you may resume.

Plan	Rate Limit	Notes
Starter	1,000 req / min	Per API key, all endpoints combined
Pro	1,000 req / min	Webhook delivery not counted
Enterprise	5,000 req / min	Dedicated infrastructure, custom limits available

Guide

Getting Started →

SDK

Python SDK →

Plans

View Pricing →