Reach
Get Profile Visitors Overview
Full "Profile Visitors" reach payload — top countries + duration users + visitors/duration chart + total counter — in one response. For a smaller card-shaped summary, use Earnings Overview with by=visitors. Requires permission api_reach_read_profile_visitors.
https://public-api.fansmetric.comGET/v1/{account_id}/reach/profile-visitors
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
start_datestringWindow start. Default 2 years ago, UTC.
end_datestringWindow end. Default end of today, UTC.
bystringBucket used to rank
topCountries. Values:total(default),guests,users,subscribers.limitintegerTop-N rows in
topCountries. Default 10. Capped at 100. Pass0for upstream default.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/reach/profile-visitors?start_date=sample_start_date&end_date=sample_end_date&by=sample_by" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"isAvailable":true
"hasStats":true
"topCountries":{
"hasMore":true
"totals":{
"total":2581195
"guests":"22445"
"users":"2558750"
"subscribers":0
}
"rows":[]
}
"topDurationUsers":{
"totals":{
"total":17803159
"guests":"258154"
"users":"17545005"
"subscribers":0
}
}
"chart":{
"visitors":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":19922
}
]
"duration":[
0:{
"date":"2025-09-01T00:00:00+00:00"
"count":116885
}
]
}
"total":{
"current":"2581195"
"delta":100
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}