List Smart Link Clicks

Query smart link clicks in a date range with optional bot/duplicate 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 clicks marked as bots. Default true

include_duplicates?boolean

Include duplicate clicks. Default true

Response Body

`application/json`

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

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

{
  "data": {
    "summary": {
      "clicks_total": 25
    },
    "chart": [
      {
        "timestamp": "2026-01-30",
        "clicks": 10
      },
      {
        "timestamp": "2026-01-31",
        "clicks": 15
      }
    ],
    "rows": [
      {
        "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
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    }
  }
}