{
  "schemaVersion": "1.0",
  "item": {
    "slug": "onlyfans-api",
    "name": "OnlyFans API Access",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/martingalovic/onlyfans-api",
    "canonicalUrl": "https://clawhub.ai/martingalovic/onlyfans-api",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/onlyfans-api",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onlyfans-api",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "onlyfans-api",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T09:41:01.133Z",
      "expiresAt": "2026-05-13T09:41:01.133Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onlyfans-api",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onlyfans-api",
        "contentDisposition": "attachment; filename=\"onlyfans-api-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "onlyfans-api"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/onlyfans-api"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/onlyfans-api",
    "agentPageUrl": "https://openagent3.xyz/skills/onlyfans-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/onlyfans-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/onlyfans-api/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OnlyFans API Skill",
        "body": "This skill queries the OnlyFansAPI.com platform to answer questions about OnlyFans agency analytics — revenue, model performance, and link conversion metrics."
      },
      {
        "title": "Prerequisites",
        "body": "The user must set the environment variable ONLYFANSAPI_API_KEY with their API key from https://app.onlyfansapi.com/api-keys.\n\nIf the key is not set, remind the user:\n\nExport your OnlyFansAPI key:\n  export ONLYFANSAPI_API_KEY=\"your_api_key_here\""
      },
      {
        "title": "API Basics",
        "body": "Base URL: https://app.onlyfansapi.com\nAuth header: Authorization: Bearer $ONLYFANSAPI_API_KEY\nAll dates use URL-encoded format: YYYY-MM-DD HH:MM:SS\nIf not specific time is specified use start of day or end of day (for date range ending date)\nPagination: use limit and offset query params. Check hasMore or _pagination.next_page in responses.\nWhenever possible use User-Agent with value: OnlyFansAPI-Skill\nTry your best to infer schema from the example response of the endpoint. Eg \"data.total.total\" for earnings scalar value from endpoint."
      },
      {
        "title": "1. Get revenue of all models for the past N days",
        "body": "Steps:\n\nList all connected accounts:\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/accounts\" | jq .\n\nEach account object has \"id\" (e.g. \"acct_xxx\"), \"onlyfans_username\", and \"display_name\".\n\n\nFor each account, get earnings:\nSTART=$(date -u -v-7d '+%Y-%m-%d+00%%3A00%%3A00')  # macOS\n# Linux: START=$(date -u -d '7 days ago' '+%Y-%m-%d+00%%3A00%%3A00')\nEND=$(date -u '+%Y-%m-%d+23%%3A59%%3A59')\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/statistics/statements/earnings?start_date=$START&end_date=$END&type=total\" | jq .\n\nResponse fields:\n\ndata.total — net earnings\ndata.gross — gross earnings\ndata.chartAmount — daily earnings breakdown array\ndata.delta — percentage change vs. prior period\n\n\n\nSummarize: Present a table of each model's display name, username, net revenue, and gross revenue. Sum the totals."
      },
      {
        "title": "2. Which model is performing the best",
        "body": "Use the same workflow as above. Rank models by data.total (net earnings) descending. The model with the highest value is the best performer.\n\nOptionally also pull the statistics overview for richer context:\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/statistics/overview?start_date=$START&end_date=$END\" | jq .\n\nThis adds subscriber counts, visitor stats, post/message earnings breakdown."
      },
      {
        "title": "3. Which Free Trial Link has the highest conversion rate (subscribers → spenders)",
        "body": "List free trial links:\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/trial-links?limit=100&offset=0&sort=desc&field=subscribe_counts&synchronous=true\" | jq .\n\nKey response fields per link:\n\nid, trialLinkName, url\nclaimCounts — total subscribers who claimed the trial\nclicksCounts — total clicks\nrevenue.total — total revenue from this link\nrevenue.spendersCount — number of subscribers who spent money\nrevenue.revenuePerSubscriber — average revenue per subscriber\n\n\n\nCalculate conversion rate:\nconversion_rate = spendersCount / claimCounts\n\nRank links by conversion rate descending.\n\n\nPresent results as a table: link name, claims, spenders, conversion rate, total revenue."
      },
      {
        "title": "4. Which Tracking Link has the highest conversion rate",
        "body": "List tracking links:\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/tracking-links?limit=100&offset=0&sort=desc&sortby=claims&synchronous=true\" | jq .\n\nKey response fields per link:\n\nid, campaignName, campaignUrl\nsubscribersCount — total subscribers from this link\nclicksCount — total clicks\nrevenue.total — total revenue\nrevenue.spendersCount — subscribers who spent\nrevenue.revenuePerSubscriber — avg revenue per subscriber\nrevenue.revenuePerClick — avg revenue per click\n\n\n\nCalculate conversion rate:\nconversion_rate = revenue.spendersCount / subscribersCount\n\n\n\nPresent results as a table: campaign name, subscribers, spenders, conversion rate, total revenue, revenue per subscriber."
      },
      {
        "title": "5. Which Free Trial / Tracking Link made the most money",
        "body": "Use the same listing endpoints above. Sort by revenue.total descending. Present the top links with their name, type (trial vs. tracking), total revenue, and subscriber/spender counts."
      },
      {
        "title": "Multi-Account (Agency) Queries",
        "body": "For agency-level queries that span all models, always:\n\nFirst fetch all accounts via GET /api/accounts\nLoop through each account and gather the relevant data\nAggregate and present combined results with per-model breakdowns"
      },
      {
        "title": "Earnings Type Filters",
        "body": "When querying GET /api/{account}/statistics/statements/earnings, the type parameter filters by category:\n\ntotal — all earnings combined\nsubscribes — subscription revenue\ntips — tips received\npost — paid post revenue\nmessages — paid message revenue\nstream — stream revenue"
      },
      {
        "title": "When In Doubt",
        "body": "If you are unsure about an endpoint, parameter, response format, or how to accomplish a specific task with the OnlyFans API, consult the official documentation at https://docs.onlyfansapi.com. The site contains full API reference details, guides, and examples for all available endpoints. Always check the docs before guessing."
      },
      {
        "title": "Error Handling",
        "body": "If ONLYFANSAPI_API_KEY is not set, stop and ask the user to configure it.\nIf an API call returns a non-200 status, show the error message and HTTP status code.\nIf _meta._rate_limits.remaining_minute or remaining_day is 0, warn the user about rate limits.\nIf an account has \"is_authenticated\": false, note that the account needs re-authentication."
      },
      {
        "title": "Output Formatting",
        "body": "Always present data in markdown tables for readability.\nInclude currency values formatted to 2 decimal places.\nWhen showing percentages (conversion rates, deltas), format as XX.X%.\nFor multi-model summaries, include a Total row at the bottom."
      }
    ],
    "body": "OnlyFans API Skill\n\nThis skill queries the OnlyFansAPI.com platform to answer questions about OnlyFans agency analytics — revenue, model performance, and link conversion metrics.\n\nPrerequisites\n\nThe user must set the environment variable ONLYFANSAPI_API_KEY with their API key from https://app.onlyfansapi.com/api-keys.\n\nIf the key is not set, remind the user:\n\nExport your OnlyFansAPI key:\n  export ONLYFANSAPI_API_KEY=\"your_api_key_here\"\n\nAPI Basics\nBase URL: https://app.onlyfansapi.com\nAuth header: Authorization: Bearer $ONLYFANSAPI_API_KEY\nAll dates use URL-encoded format: YYYY-MM-DD HH:MM:SS\nIf not specific time is specified use start of day or end of day (for date range ending date)\nPagination: use limit and offset query params. Check hasMore or _pagination.next_page in responses.\nWhenever possible use User-Agent with value: OnlyFansAPI-Skill\nTry your best to infer schema from the example response of the endpoint. Eg \"data.total.total\" for earnings scalar value from endpoint.\nWorkflows\n1. Get revenue of all models for the past N days\n\nSteps:\n\nList all connected accounts:\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/accounts\" | jq .\n\n\nEach account object has \"id\" (e.g. \"acct_xxx\"), \"onlyfans_username\", and \"display_name\".\n\nFor each account, get earnings:\n\nSTART=$(date -u -v-7d '+%Y-%m-%d+00%%3A00%%3A00')  # macOS\n# Linux: START=$(date -u -d '7 days ago' '+%Y-%m-%d+00%%3A00%%3A00')\nEND=$(date -u '+%Y-%m-%d+23%%3A59%%3A59')\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/statistics/statements/earnings?start_date=$START&end_date=$END&type=total\" | jq .\n\n\nResponse fields:\n\ndata.total — net earnings\ndata.gross — gross earnings\ndata.chartAmount — daily earnings breakdown array\ndata.delta — percentage change vs. prior period\n\nSummarize: Present a table of each model's display name, username, net revenue, and gross revenue. Sum the totals.\n\n2. Which model is performing the best\n\nUse the same workflow as above. Rank models by data.total (net earnings) descending. The model with the highest value is the best performer.\n\nOptionally also pull the statistics overview for richer context:\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/statistics/overview?start_date=$START&end_date=$END\" | jq .\n\n\nThis adds subscriber counts, visitor stats, post/message earnings breakdown.\n\n3. Which Free Trial Link has the highest conversion rate (subscribers → spenders)\n\nList free trial links:\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/trial-links?limit=100&offset=0&sort=desc&field=subscribe_counts&synchronous=true\" | jq .\n\n\nKey response fields per link:\n\nid, trialLinkName, url\nclaimCounts — total subscribers who claimed the trial\nclicksCounts — total clicks\nrevenue.total — total revenue from this link\nrevenue.spendersCount — number of subscribers who spent money\nrevenue.revenuePerSubscriber — average revenue per subscriber\n\nCalculate conversion rate:\n\nconversion_rate = spendersCount / claimCounts\n\n\nRank links by conversion rate descending.\n\nPresent results as a table: link name, claims, spenders, conversion rate, total revenue.\n\n4. Which Tracking Link has the highest conversion rate\n\nList tracking links:\n\ncurl -s -H \"Authorization: Bearer $ONLYFANSAPI_API_KEY\" \\\n  \"https://app.onlyfansapi.com/api/{account_id}/tracking-links?limit=100&offset=0&sort=desc&sortby=claims&synchronous=true\" | jq .\n\n\nKey response fields per link:\n\nid, campaignName, campaignUrl\nsubscribersCount — total subscribers from this link\nclicksCount — total clicks\nrevenue.total — total revenue\nrevenue.spendersCount — subscribers who spent\nrevenue.revenuePerSubscriber — avg revenue per subscriber\nrevenue.revenuePerClick — avg revenue per click\n\nCalculate conversion rate:\n\nconversion_rate = revenue.spendersCount / subscribersCount\n\n\nPresent results as a table: campaign name, subscribers, spenders, conversion rate, total revenue, revenue per subscriber.\n\n5. Which Free Trial / Tracking Link made the most money\n\nUse the same listing endpoints above. Sort by revenue.total descending. Present the top links with their name, type (trial vs. tracking), total revenue, and subscriber/spender counts.\n\nMulti-Account (Agency) Queries\n\nFor agency-level queries that span all models, always:\n\nFirst fetch all accounts via GET /api/accounts\nLoop through each account and gather the relevant data\nAggregate and present combined results with per-model breakdowns\nEarnings Type Filters\n\nWhen querying GET /api/{account}/statistics/statements/earnings, the type parameter filters by category:\n\ntotal — all earnings combined\nsubscribes — subscription revenue\ntips — tips received\npost — paid post revenue\nmessages — paid message revenue\nstream — stream revenue\nWhen In Doubt\n\nIf you are unsure about an endpoint, parameter, response format, or how to accomplish a specific task with the OnlyFans API, consult the official documentation at https://docs.onlyfansapi.com. The site contains full API reference details, guides, and examples for all available endpoints. Always check the docs before guessing.\n\nError Handling\nIf ONLYFANSAPI_API_KEY is not set, stop and ask the user to configure it.\nIf an API call returns a non-200 status, show the error message and HTTP status code.\nIf _meta._rate_limits.remaining_minute or remaining_day is 0, warn the user about rate limits.\nIf an account has \"is_authenticated\": false, note that the account needs re-authentication.\nOutput Formatting\nAlways present data in markdown tables for readability.\nInclude currency values formatted to 2 decimal places.\nWhen showing percentages (conversion rates, deltas), format as XX.X%.\nFor multi-model summaries, include a Total row at the bottom."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/martingalovic/onlyfans-api",
    "publisherUrl": "https://clawhub.ai/martingalovic/onlyfans-api",
    "owner": "martingalovic",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/onlyfans-api",
    "downloadUrl": "https://openagent3.xyz/downloads/onlyfans-api",
    "agentUrl": "https://openagent3.xyz/skills/onlyfans-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/onlyfans-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/onlyfans-api/agent.md"
  }
}