List Smart Link Conversions

Query smart link conversions in a date range with optional bot/duplicate and conversion type filtering

Authorization

default

AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

account*string

The Account ID

smart_link_id*string

The ID of the smart link.

Query Parameters

date_start?string

Optional report range start date

date_end?string

Optional report range end date

limit?integer

Rows per page. Default 100

offset?integer

Offset for pagination. Default 0

include_bots?boolean

Include conversions from clicks marked as bots. Default true

include_duplicates?boolean

Include conversions from duplicate clicks. Default true

conversion_type?string

Optional conversion type filter

Value in"new_subscriber" | "new_transaction"

Response Body

`application/json`

curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/smart-links/ipsam/conversions?date_start=2026-01-01T00%3A00%3A00Z&date_end=2026-01-07T23%3A59%3A59Z&limit=100&offset=0&include_bots=true&include_duplicates=true&conversion_type=new_transaction"

curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/smart-links/ipsam/conversions?date_start=2026-01-01T00%3A00%3A00Z&date_end=2026-01-07T23%3A59%3A59Z&limit=100&offset=0&include_bots=true&include_duplicates=true&conversion_type=new_transaction"

{
  "data": {
    "summary": {
      "conversions_total": 6,
      "subscribers_total": 3,
      "revenue_total": 240.5
    },
    "chart": [
      {
        "timestamp": "2026-01-30",
        "conversions": 2
      },
      {
        "timestamp": "2026-01-31",
        "conversions": 4
      }
    ],
    "rows": [
      {
        "id": "01JTESTCONV0000000000000001",
        "conversion_type": "new_transaction",
        "amount_gross": 120.25,
        "amount_net": 100,
        "conversion_at": "2026-01-31T22:15:00+00:00",
        "fan_onlyfans_id": "123456789",
        "fan": {
          "onlyfans_id": "123456789",
          "username": "demo_fan",
          "name": "Demo Fan",
          "avatar_url": "https://cdn.example.com/avatar.jpg",
          "onlyfans_url": "https://onlyfans.com/demo_fan"
        },
        "click": {
          "id": "01JTESTCLICK000000000000001",
          "created_at": "2026-01-31T21:45:00+00:00",
          "referrer": "example.com",
          "ip_address": "192.168.1.10",
          "user_agent": "Mozilla/5.0",
          "browser_device_type": "Desktop",
          "browser_name": "Chrome",
          "browser_family": "Chrome",
          "browser_platform": "macOS",
          "is_bot": false,
          "is_duplicate": false,
          "country_code": "US",
          "external_click_id": "ext_123",
          "gross_clicks": 1,
          "fbclid": null,
          "aff_s1": "campaign-a",
          "aff_s2": null,
          "aff_s3": null,
          "aff_s4": null,
          "aff_s5": null,
          "utm_source": "google",
          "utm_medium": "cpc",
          "utm_campaign": "winter",
          "utm_content": "creative-a",
          "utm_term": "fans"
        }
      }
    ],
    "filters": {
      "date_start": "2026-01-25T00:00:00+00:00",
      "date_end": "2026-01-31T23:59:59+00:00",
      "limit": 100,
      "offset": 0,
      "include_bots": true,
      "include_duplicates": true,
      "conversion_type": "new_transaction"
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    }
  }
}