Get Post Stats
Get the statistics of one of the account's posts, as shown on the Fansly creator dashboard: post engagement, and media views, watch time and retention split by traffic source (For You Page vs. timeline/direct, and optionally suggestions, search and other).
Engagement. engagement has the post's likes, unlikes and comments for the window. Fansly returns nothing for a post without recorded engagement, and the counters are then null (unknown), not 0.
Media. Fansly measures views per media offer, not per post, so offers has one entry per distinct media offer attached to the post (bundles are expanded; attribution: media_offer). 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 offers; attachments that are not media offers are listed in otherAttachments.
For each offer, sources has one entry per requested source (sources, default For You 0 and timeline 1) with that source's media: one entry per media asset. A preview asset is reported as its own entry, so compare mediaId with the offer's previewId. Per media:
totalsโ views, impressions,watchMs,videoViews,completedViews,watchPctSum,replaysfor the whole window. Can benullwhiledailyhas data.averageWatchMs(watchMs / videoViews) andaverageWatchPercent(watchPctSum / videoViews / 100, the dashboard's formula) โ videos only, otherwisenull. Photos can havewatchMs(viewing time) without video views.dailyโ per-day rows, the only place withuniqueViewers. Unique viewers are not additive: do not sum them across days, sources or media.hoursโ per-hour rows, which Fansly can return beyondbeforeBucket.retentionโstillWatching(a fraction) at each playbackpercent, withretentionSampleSize.tagsโ per-hashtag views (see Get Post Hashtag Stats for hashtag names).
Do not add sources together as the media's total views: other sources exist. mediaLikes are the offer's media likes by source (not filtered by the requested sources), separate from post engagement.
Full content vs. preview. previewSplit separates views of the full (unlocked) content from views of the offer's free preview, which is how locked media is measured. totals has one row per traffic source that had activity, whatever sources you requested: views / interactionTime for the full content and previewViews / previewInteractionTime for the preview (milliseconds), with averageInteractionMs / previewAverageInteractionMs per view (null without views). datapoints are Fansly's daily rows, where each stats[] entry's type is the traffic source and uniqueViewers / previewUniqueViewers are per day only. dateAfter / dateBefore are this series' own window, which can be one UTC day earlier than the rest of the response. If Fansly fails this part, previewSplit has available: false and the upstream error; the other statistics are still returned.
Unique viewers are only available per day (daily, datapoints). Fansly provides no unique-viewer count for the whole range, and the daily, source, media, full and preview counts must not be added up into one.
Window. afterBucket / beforeBucket are the window Fansly actually used; it snaps before down to UTC midnight, so the current partial day is not included.
Each media offer costs one Fansly call per requested source plus one for previewSplit, so request only the sources you need.
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.
Traffic sources to report: 0 = For You, 1 = Timeline (direct), 2 = Suggestions, 3 = Search, 4 = Other. Defaults to [0, 1].
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/stats?after=2026-10-18T00%3A00%3A00Z&before=2026-11-17T00%3A00%3A00Z&sources=0%2C1" \ -H "Content-Type: application/json" \ -d '{ "sources": [ 4 ] }'{
"data": {
"postId": "400000000000000002",
"requestedAfter": 1792281600000,
"requestedBefore": 1794873600000,
"engagement": {
"afterBucket": 1792281600000,
"beforeBucket": 1794873600000,
"likes": 5,
"unlikes": 0,
"comments": 0
},
"attribution": "media_offer",
"mediaOfferIds": [
"500000000000000001"
],
"unresolvedBundleIds": [],
"otherAttachments": [],
"offers": [
{
"mediaOfferId": "500000000000000001",
"previewId": null,
"locations": [
{
"id": "900000000000000001",
"mediaOfferId": "500000000000000001",
"mediaOfferBundleId": null,
"mediaId": "500000000000000101",
"accountId": "800000000000000001",
"locationId": "800000000000000001",
"correlationId": "400000000000000002",
"createdAt": 1794951600000
}
],
"mediaLikes": [
{
"source": 0,
"bucket": "1794355200000",
"likes": 25,
"unlikes": 0
},
{
"source": 4,
"bucket": "1794355200000",
"likes": 0,
"unlikes": 1
}
],
"sources": [
{
"source": 0,
"sourceName": "for_you",
"afterBucket": 1792281600000,
"beforeBucket": 1794873600000,
"media": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"totals": {
"mediaId": "500000000000000101",
"mediaOfferId": "500000000000000001",
"source": 0,
"mediaType": 2,
"durationMs": 7133,
"views": 1578,
"impressions": 1578,
"watchMs": 6282258,
"videoViews": 1578,
"completedViews": 306,
"watchPctSum": 6181941,
"replays": 162
},
"averageWatchMs": 3981.1520912548,
"averageWatchPercent": 39.175798479087,
"daily": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"durationMs": 7133,
"source": 0,
"bucket": "1794268800000",
"views": 3,
"impressions": 3,
"watchMs": 24651,
"videoViews": 3,
"completedViews": 1,
"watchPctSum": 13906,
"replays": 2,
"uniqueViewers": 3
}
],
"hours": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"source": 0,
"hourBucket": "1794794400000",
"views": 2,
"impressions": 2,
"watchMs": 2193,
"videoViews": 2,
"completedViews": 0,
"watchPctSum": 3075,
"replays": 0
}
],
"retention": [
{
"percent": 0,
"stillWatching": 1
},
{
"percent": 5,
"stillWatching": 0.90937896070976
}
],
"retentionSampleSize": 1578,
"tags": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"tagId": "436274809547010049",
"kind": 1,
"views": 3,
"watchMs": 1184,
"videoViews": 3,
"completedViews": 0,
"watchPctSum": 1660
}
]
}
]
},
{
"source": 1,
"sourceName": "timeline",
"afterBucket": 1792281600000,
"beforeBucket": 1794873600000,
"media": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"totals": {
"mediaId": "500000000000000101",
"mediaOfferId": "500000000000000001",
"source": 1,
"mediaType": 2,
"durationMs": 7133,
"views": 4,
"impressions": 4,
"watchMs": 25960,
"videoViews": 4,
"completedViews": 2,
"watchPctSum": 30000,
"replays": 0
},
"averageWatchMs": 6490,
"averageWatchPercent": 75,
"daily": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"durationMs": 7133,
"source": 1,
"bucket": "1794268800000",
"views": 3,
"impressions": 3,
"watchMs": 24651,
"videoViews": 3,
"completedViews": 1,
"watchPctSum": 13906,
"replays": 2,
"uniqueViewers": 3
}
],
"hours": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"source": 1,
"hourBucket": "1794794400000",
"views": 2,
"impressions": 2,
"watchMs": 2193,
"videoViews": 2,
"completedViews": 0,
"watchPctSum": 3075,
"replays": 0
}
],
"retention": [
{
"percent": 0,
"stillWatching": 1
},
{
"percent": 5,
"stillWatching": 0.90937896070976
}
],
"retentionSampleSize": 4,
"tags": [
{
"mediaId": "500000000000000101",
"mediaType": 2,
"tagId": "436274809547010049",
"kind": 1,
"views": 3,
"watchMs": 1184,
"videoViews": 3,
"completedViews": 0,
"watchPctSum": 1660
}
]
}
]
}
],
"previewSplit": {
"available": true,
"dateAfter": 1792195200000,
"dateBefore": 1794787200000,
"period": 86400000,
"totals": [
{
"source": 1,
"sourceName": "timeline",
"views": 0,
"previewViews": 89,
"interactionTime": 0,
"previewInteractionTime": 326350,
"averageInteractionMs": null,
"previewAverageInteractionMs": 3666.8539325843
}
],
"datapoints": [
{
"timestamp": 1794787200000,
"stats": []
},
{
"timestamp": 1794268800000,
"stats": [
{
"type": 1,
"views": 0,
"previewViews": 34,
"interactionTime": 0,
"previewInteractionTime": 107445,
"uniqueViewers": 0,
"previewUniqueViewers": 27
}
]
},
{
"timestamp": 1794182400000,
"stats": [
{
"type": 1,
"views": 0,
"previewViews": 55,
"interactionTime": 0,
"previewInteractionTime": 218905,
"uniqueViewers": 0,
"previewUniqueViewers": 42
}
]
}
]
}
}
]
},
"_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."
}
}
}