Engagement
List Top Posts by Engagement
Returns a paginated leaderboard of top-performing posts ranked by a single engagement metric. Unlike /highlights/post (one top post per metric, no pagination), this returns the full ranked list for one metric. Requires permission api_engagement_list_posts.
https://public-api.buffmetrics.comGET/v1/{account_id}/engagement/posts/{by}
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.
by*stringRanking metric. One of
comments,likes,views,tips,purchases.
Query Parameters
start_datestringWindow start. Default 2 years ago, UTC.
end_datestringWindow end. Default end of today, UTC.
offsetintegerRows to skip. Page size is fixed at 10.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/engagement/posts/sample_by?start_date=sample_start_date&end_date=sample_end_date&offset=0" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"hasMore":true
"items":[
0:{
"id":2155691024
"postedAt":"2025-12-17T03:05:15+00:00"
"rawText":"not sorry for being too naughty"
"favoritesCount":666
"mediaCount":1
"isPinned":false
"stats":{
"lookCount":8810
"uniqueLookCount":4947
"likeCount":666
"commentCount":0
"tipCount":0
"tipSum":0
"purchasedCount":0
"purchasedSumm":0
}
"media":[]
}
]
}
"_pagination":{
"next_page":"/v1/523213896/engagement/posts/likes?start_date=2025-09-17%2004%3A23%3A50&end_date=2026-05-28%2013%3A22%3A18&offset=10"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}