Get Post Hashtag Stats
Get For You Page (FYP) statistics per hashtag for one of the account's posts: how many views each hashtag brought in and how long those viewers engaged.
Fansly measures hashtags per media item, not per post, so these are the stats of the media attached to the post (attribution: media_offer). A post with several media, or a bundle, has each media fetched once and the hashtag rows summed across them; offers keeps the per-media breakdown. If the same media is also used in another post, that post reports the same numbers — they are not traffic exclusive to this post. A post without media has no hashtag stats.
For each hashtag, views / interactionTime count full-content views and previewViews / previewInteractionTime count preview views; totalViews adds both. interactionTime values are total milliseconds. averageEngagementSeconds, previewAverageEngagementSeconds, and totalAverageEngagementSeconds are total engagement time divided by views (unrounded; the Fansly dashboard shows one decimal), and are null when there are no views. tag is the hashtag itself; label is an optional display label and is often null.
Each offer's dateAfter / dateBefore is the window Fansly actually returned, which can differ from the requested after / before (Fansly has been seen returning a window one UTC day earlier). Statistics cover the whole window; there is no per-day hashtag breakdown.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fansly Account ID
The Fansly post ID.
Query Parameters
Start of the date range (ISO 8601). Defaults to 30 days ago.
End of the date range (ISO 8601). Defaults to now.
Request Body
application/json
Must be a valid date. Must be a date before now.
Must be a valid date.
Response Body
application/json
curl -X GET "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/posts/400000000000000001/hashtag-stats?after=2026-10-18T00%3A00%3A00Z&before=2026-11-17T00%3A00%3A00Z" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"postId": "400000000000000001",
"attribution": "media_offer",
"requestedAfter": 1792281600000,
"requestedBefore": 1794873600000,
"mediaOfferIds": [
"500000000000000001"
],
"unresolvedBundleIds": [],
"tags": [
{
"tagId": "436274804878749747",
"tag": "emo",
"label": null,
"views": 2,
"previewViews": 0,
"totalViews": 2,
"interactionTime": 22437,
"previewInteractionTime": 0,
"averageEngagementSeconds": 11.2185,
"previewAverageEngagementSeconds": null,
"totalAverageEngagementSeconds": 11.2185,
"mediaOfferIds": [
"500000000000000001"
]
},
{
"tagId": "436274809547010058",
"tag": "tiktok",
"label": null,
"views": 2,
"previewViews": 0,
"totalViews": 2,
"interactionTime": 4016,
"previewInteractionTime": 0,
"averageEngagementSeconds": 2.008,
"previewAverageEngagementSeconds": null,
"totalAverageEngagementSeconds": 2.008,
"mediaOfferIds": [
"500000000000000001"
]
}
],
"offers": [
{
"mediaOfferId": "500000000000000001",
"dateAfter": 1792195200000,
"dateBefore": 1794787200000,
"period": 86400000,
"tags": [
{
"tagId": "436274804878749747",
"tag": "emo",
"label": null,
"views": 2,
"previewViews": 0,
"totalViews": 2,
"interactionTime": 22437,
"previewInteractionTime": 0,
"averageEngagementSeconds": 11.2185,
"previewAverageEngagementSeconds": null,
"totalAverageEngagementSeconds": 11.2185
},
{
"tagId": "436274809547010058",
"tag": "tiktok",
"label": null,
"views": 2,
"previewViews": 0,
"totalViews": 2,
"interactionTime": 4016,
"previewInteractionTime": 0,
"averageEngagementSeconds": 2.008,
"previewAverageEngagementSeconds": null,
"totalAverageEngagementSeconds": 2.008
}
],
"locations": [
{
"id": "500000000000000101",
"mediaOfferId": "500000000000000001",
"mediaOfferType": 2001,
"mediaOfferBundleId": null,
"mediaId": "500000000000000201",
"accountId": "800000000000000001",
"locationId": "800000000000000001",
"correlationId": "400000000000000001",
"createdAt": 1794339663000
}
]
}
]
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055789,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}