Smart Links
List Smart Link Fans
Query attributed Smart Link fans with aggregate fan metrics and subscriber attribution metadata
get/api/smart-links/{smart_link_id}/fans
Query parameters
limitinteger
Rows per page. Default 100
Example:100
Rows per page. Default 100
offsetinteger
Offset for pagination. Default 0
Offset for pagination. Default 0
sort'revenue_net' | '-revenue_net' | 'tips_net' | '-tips_net' | 'messages_sent_by_fan' | '-messages_sent_by_fan' | 'converted_at' | '-converted_at'
Optional sort field. Default -revenue_net
Example:-revenue_net
Optional sort field. Default -revenue_net
has_messagesboolean
Optional - Filter to fans with or without fan-sent messages
Example:true
Optional - Filter to fans with or without fan-sent messages
min_messages_sent_by_faninteger
Optional minimum number of messages sent by fan
Example:3
Optional minimum number of messages sent by fan
min_revenue_netnumber
Optional minimum net revenue
Example:25
Optional minimum net revenue
min_tips_netnumber
Optional minimum net tips
Example:10
Optional minimum net tips
Response
Success
Example response
{
"data": {
"summary": {
"fans_total": 3,
"revenue_net_total": 145,
"tips_net_total": 45,
"fans_with_3_plus_messages_total": 1
},
"rows": [
{
"fan_id": 101,
"onlyfans_id": "100000001",
"username": "demo_fan_a",
"name": "Demo Fan A",
"avatar_url": "https://cdn.example.com/avatar-a.jpg",
"revenue_net": 90,
"tips_net": 30,
"messages_sent_by_fan": 4,
"converted_at": "2026-01-12T12:00:00+00:00",
"conversion_id": 9001,
"click_id": "01JTESTCLICK000000000000001",
"external_click_id": "ext-a"
},
{
"fan_id": 102,
"onlyfans_id": "100000002",
"username": "demo_fan_b",
"name": "Demo Fan B",
"avatar_url": "https://cdn.example.com/avatar-b.jpg",
"revenue_net": 40,
"tips_net": 10,
"messages_sent_by_fan": 2,
"converted_at": "2026-01-10T10:00:00+00:00",
"conversion_id": 9002,
"click_id": "01JTESTCLICK000000000000002",
"external_click_id": "ext-b"
},
{
"fan_id": 103,
"onlyfans_id": "100000003",
"username": "demo_fan_c",
"name": "Demo Fan C",
"avatar_url": null,
"revenue_net": 15,
"tips_net": 5,
"messages_sent_by_fan": 0,
"converted_at": null,
"conversion_id": null,
"click_id": null,
"external_click_id": null
}
],
"filters": {
"limit": 100,
"offset": 0,
"sort": "-revenue_net",
"has_messages": null,
"min_messages_sent_by_fan": null,
"min_revenue_net": null,
"min_tips_net": null
}
},
"_meta": {
"_credits": {
"used": 0,
"balance": 999999,
"note": "Free endpoint"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
}
}
}