Build reports for gross and net revenue, fan spending, new subscriptions and renewals. Query dated OnlyFans metrics through one API, with explicit limits when historical data is unavailable.
Read transaction-ledger totals for a selected UTC date range: gross revenue, platform fees, net revenue and transaction count. Add revenue by fan, historical charts and new or renewed subscription events. These reports use your connected creator's native data.
/analytics/earnings returns dated totals. Net transaction revenue is distinct from bank payouts and business profit.
Use /analytics/transactions/summary and /analytics/transactions/count to check ledger totals for the same period.
/analytics/fans attributes revenue during the selected dates. Include the unattributed bucket and any remaining fan rows when checking totals.
/analytics/subscribers reports subscription events. Detailed paid/free counts keep missing historical prices explicitly unknown.
/analytics/historical groups revenue by day or month. Use consistent dates and currency across creators.
/analytics/fans/{fan_id}/lifetime exposes provider-reported lifetime fields. Keep these separate from period and campaign revenue.
All paths above follow /v1/{account}. Use start_date and end_date for reproducible revenue reports. Date-only ends include the whole UTC day. Subscription reports require both dates and accept a maximum 366-day range. These examples cover OnlyFans; consult each platform's reference for its available reports.
Replace the account placeholder and choose your reporting dates. This example reads data; it does not change platform content.
# gross, net, platform fees and transaction count
curl --get "https://api.creator-api.com/v1/{account}/analytics/earnings" \
-H "X-API-Key: $CREATOR_API_KEY" \
--data-urlencode "start_date=2026-10-06" \
--data-urlencode "end_date=2026-10-06"
The response includes total_gross, total_net, total_fees and count. Follow the revenue and CSV export walkthrough to reconcile fan totals, read subscription details and download ledger rows.
Dated reports include transaction count, gross revenue, platform fees, net revenue, revenue by fan and monetary time series. Subscription reports separate total, new and renewed events.
No. These reports count subscription events in the selected UTC date range. They are not the number of currently active or unique subscribers.
Use detailed=true. Paid and free counts rely on dated historical prices. Missing prices remain unknown, and the complete field tells you whether all events could be classified.
No. The lifetime endpoint exposes provider-reported lifetime fields. Use analytics/fans with dates for period revenue. Neither measure automatically establishes campaign attribution.
Read each authorized creator with the same date range and currency, then aggregate in your own application. Account access and creator limits depend on your API key and plan.
OnlyFans API reference · Revenue reporting and exports · Build an OnlyFans CRM · Webhook delivery and retries
Get your key, connect an account and pull your first earnings report in minutes.