Engagement
List Top Stories by Engagement
Paginated leaderboard of top-performing stories by a single engagement metric. Parallel to List Top Posts — same shape, same pagination, but for stories. Stories aren't purchasable, so by=purchases is not valid here. Requires permission api_engagement_list_stories.
https://public-api.fansmetric.comGET/v1/{account_id}/engagement/stories/{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
tips,views,likes,comments.
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.fansmetric.com/v1/acct_XXXXX/engagement/stories/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":94660491
"userId":523213896
"createdAt":"2026-05-27T13:00:00+00:00"
"media":[]
"tipsAmount":"$200"
"tipsAmountRaw":200
"tipsCount":8
"likesCount":412
"commentsCount":17
"viewersCount":9821
"viewers":[]
"isHighlightCover":false
"isLastInHighlight":false
}
]
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}