ONonlyfansapi
Free Trial Links

Get Free Trial Link Stats

Changed on

Get dashboard-style summary plus daily and monthly metrics for a specific Free Trial Link

get/api/{account}/trial-links/{trial_link_id}/stats

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/{account}/trial-links/{trial_link_id}/stats
  • Auth
    HTTP bearer

Query parameters

date_startstring

Optional stats range start date

Example:2026-01-01T00:00:00Z
date_endstring

Optional stats range end date

Example:2026-01-31T23:59:59Z

Response

Success

Example response

{
  "data": {
    "summary": {
      "clicks_total": 182,
      "subs_total": 123,
      "revenue_total": 123,
      "chargebacks_total": 12,
      "spenders_total": 16,
      "revenue_cached_at": "2026-01-31T23:59:59+00:00"
    },
    "daily_metrics": [
      {
        "timestamp": "2026-01-30",
        "clicks": 5,
        "subs": 3,
        "revenue": 12.5,
        "spenders": 1
      },
      {
        "timestamp": "2026-01-31",
        "clicks": 8,
        "subs": 4,
        "revenue": 21,
        "spenders": 2
      }
    ],
    "monthly_metrics": [
      {
        "timestamp": "2026-01-01",
        "clicks": 182,
        "subs": 123,
        "revenue": 123,
        "spenders": 16
      }
    ]
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    }
  }
}

Changes