onlyfansapi/skill

Overview

This skill queries OnlyFansAPI.com to provide agency-grade analytics for OnlyFans accounts. It returns revenue summaries, ranks model performance, and analyzes conversion metrics for Free Trial and Tracking Links. The skill is built to aggregate across multiple accounts and deliver clear, actionable summaries.

How this skill works

The skill lists connected accounts, then calls statistics and link endpoints for each account to gather earnings, subscriber, and link data. It computes aggregates (totals, conversion rates, ranking) and formats results for easy interpretation. It checks API responses for pagination, rate limits, and authentication status and surfaces errors or required re-authentication when needed.

When to use it

• Calculate total net and gross revenue across all models for a given date range.
• Identify the top-performing model by net earnings or by more detailed overview metrics.
• Find which Free Trial or Tracking Link has the highest conversion rate or highest revenue.
• Compare link-level revenue metrics like revenue per subscriber or revenue per click.
• Perform agency-level rollups and per-model breakdowns for reporting.

Best practices

• Set ONLYFANSAPI_API_KEY in your environment before running queries; stop and prompt if missing.
• Always fetch all accounts first and then loop per-account for accurate agency aggregates.
• Use date ranges with URL-encoded timestamps (YYYY-MM-DD HH:MM:SS) and include start/end semantics.
• Respect pagination (limit/offset) and watch hasMore or _pagination.next_page in responses.
• Check API rate-limit fields and handle non-200 responses with the HTTP status and message.

Example use cases

• Weekly revenue report: sum net/gross earnings for all models over the previous 7 days and list top 5 earners.
• Conversion audit: list Free Trial links ranked by spenders/claims conversion rate and highlight underperforming campaigns.
• Link ROI comparison: compare tracking links by revenue.total, revenuePerSubscriber, and revenuePerClick for a campaign.
• Re-authentication check: detect accounts with is_authenticated=false and provide a re-authentication action list.
• Earnings breakdown: pull statistics/overview for a model to show subscriptions vs tips vs PPV revenue.