Highlights
Top Highlights
Returns the single top-performing record per metric for a content category over a date window — the post / message / stream / story / fan that scored highest on each leaderboard slot. The "highlights" view used to populate the OnlyFans "Top of period" cards. Requires permission api_highlights_read.
https://public-api.fansmetric.comGET/v1/{account_id}/highlights/{category}
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.
category*stringOne of
post,message,stream,story,fan.
Query Parameters
start_datestringWindow start. Default 2 years ago, UTC. Format
YYYY-MM-DD HH:MM:SSor ISO 8601.end_datestringWindow end. Default end of today, UTC. Same format as
start_date.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/highlights/sample_category?start_date=sample_start_date&end_date=sample_end_date" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"purchases":{
"id":2155691024
"postedAt":"2025-12-17T03:05:15+00:00"
"rawText":"not sorry for being too naughty"
"price":9.99
"stats":{
"lookCount":8810
"uniqueLookCount":4947
"likeCount":666
"commentCount":0
"purchasedCount":41
"purchasedSumm":409.59
"tipCount":0
"tipSum":0
}
"media":[]
}
"tips":null
"views":null
"likes":null
"comments":null
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}