Smart Links
List Smart Link Clicks
Query smart link clicks in a date range with optional bot/duplicate filtering
get/api/smart-links/{smart_link_id}/clicks
Query parameters
date_startstring
Optional report range start date
Example:2026-01-01T00:00:00Z
Optional report range start date
date_endstring
Optional report range end date
Example:2026-01-07T23:59:59Z
Optional report range end date
limitinteger
Rows per page. Default 100
Example:100
Rows per page. Default 100
offsetinteger
Offset for pagination. Default 0
Offset for pagination. Default 0
include_botsboolean
Include clicks marked as bots. Default true
Example:true
Include clicks marked as bots. Default true
include_duplicatesboolean
Include duplicate clicks. Default true
Example:true
Include duplicate clicks. Default true
Response
Success
Example response
{
"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,
"gclid": "google-click-id",
"ttclid": "tiktok-click-id",
"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": 0,
"balance": 999999,
"note": "Free endpoint"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
}
}
}