NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
FanslyPosts

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.

GET
/api/fansly/{fanslyAccount}/posts/{post_id}/hashtag-stats
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

fanslyAccount*string

The Fansly Account ID

post_id*string

The Fansly post ID.

Query Parameters

after?string

Start of the date range (ISO 8601). Defaults to 30 days ago.

before?string

End of the date range (ISO 8601). Defaults to now.

Request Body

application/json

after?string|null

Must be a valid date. Must be a date before now.

before?string|null

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."
    }
  }
}