> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Insights (/api-reference/fansly/profile-statistics/get-insights)

Get viewer engagement insights for the Fansly Account — views, interaction time, unique viewers, and video stats — bucketed by the granularity of the chosen range.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/insights
openapi: 3.0.3
info:
  title: Fansly API Documentation
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: Account
    description: Endpoints for your linked Fansly accounts
  - name: Chats
    description: Endpoints for Fansly chats (messaging groups)
  - name: Earnings
    description: Endpoints for Fansly Earnings — wallets, balances, transactions,
      payouts, and statements.
  - name: Followers
    description: Endpoints for Fansly followers.
  - name: Lists
    description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders").
  - name: Profile Statistics
    description: Endpoints for Fansly Profile Statistics (viewer engagement insights).
  - name: Subscribers
    description: Endpoints for Fansly subscribers and subscription tiers.
  - name: Top Supporters
    description: Endpoints for the Fansly "Top Supporters" view — see who spends the
      most and what they spend on.
  - name: Tracking Links
    description: Endpoints for Fansly tracking links — per-source attribution links
      (e.g. "Twitter bio", "FYP", "Search").
  - name: Users
    description: APIs for fetching Fansly users
paths:
  /api/fansly/{fanslyAccount}/insights:
    parameters:
      - in: path
        name: fanslyAccount
        description: The Fansly Account ID
        example: fansly_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: Get Insights
      operationId: getInsights
      description: Get viewer engagement insights for the Fansly Account — views,
        interaction time, unique viewers, and video stats — bucketed by the
        granularity of the chosen range.
      parameters:
        - in: query
          name: range
          description: Time range for the report. Default = last_30_days. Each range
            determines the bucket size (5min / 1h / 6h / 1d).
          example: last_30_days
          required: false
          schema:
            type: string
            description: Time range for the report. Default = last_30_days. Each range
              determines the bucket size (5min / 1h / 6h / 1d).
            example: last_30_days
            enum:
              - last_hour
              - last_24h
              - last_7_days
              - last_30_days
              - month
        - in: query
          name: month
          description: "Required when `range=month`. Format: YYYY-MM (e.g. `2026-05`).
            Ignored for other ranges."
          example: 2026-05
          required: false
          schema:
            type: string
            description: "Required when `range=month`. Format: YYYY-MM (e.g. `2026-05`).
              Ignored for other ranges."
            example: 2026-05
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    dataset:
                      period: 86400000
                      dateBefore: 1780444800000
                      dateAfter: 1777852800000
                      datapointLimit: 100
                      datapoints:
                        - timestamp: 1780444800000
                          stats:
                            - type: 0
                              views: 672
                              previewViews: 0
                              interactionTime: 2459162
                              previewInteractionTime: 0
                              uniqueViewers: 431
                              previewUniqueViewers: 0
                              videoViews: 672
                              totalVideoPercentWatched: 184.62
                              previewVideoViews: 0
                              previewTotalVideoPercentWatched: 0
                            - type: 1
                              views: 394
                              previewViews: 3
                              interactionTime: 4685121
                              previewInteractionTime: 2014
                              uniqueViewers: 128
                              previewUniqueViewers: 1
                              videoViews: 263
                              totalVideoPercentWatched: 128.59
                              previewVideoViews: 0
                              previewTotalVideoPercentWatched: 0
                  _meta:
                    _credits:
                      used: 1
                      balance: 10055780
                      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.
                properties:
                  data:
                    type: object
                    properties:
                      dataset:
                        type: object
                        properties:
                          period:
                            type: integer
                            example: 86400000
                          dateBefore:
                            type: integer
                            example: 1780444800000
                          dateAfter:
                            type: integer
                            example: 1777852800000
                          datapointLimit:
                            type: integer
                            example: 100
                          datapoints:
                            type: array
                            example:
                              - timestamp: 1780444800000
                                stats:
                                  - type: 0
                                    views: 672
                                    previewViews: 0
                                    interactionTime: 2459162
                                    previewInteractionTime: 0
                                    uniqueViewers: 431
                                    previewUniqueViewers: 0
                                    videoViews: 672
                                    totalVideoPercentWatched: 184.62
                                    previewVideoViews: 0
                                    previewTotalVideoPercentWatched: 0
                                  - type: 1
                                    views: 394
                                    previewViews: 3
                                    interactionTime: 4685121
                                    previewInteractionTime: 2014
                                    uniqueViewers: 128
                                    previewUniqueViewers: 1
                                    videoViews: 263
                                    totalVideoPercentWatched: 128.59
                                    previewVideoViews: 0
                                    previewTotalVideoPercentWatched: 0
                            items:
                              type: object
                              properties:
                                timestamp:
                                  type: integer
                                  example: 1780444800000
                                stats:
                                  type: array
                                  example:
                                    - type: 0
                                      views: 672
                                      previewViews: 0
                                      interactionTime: 2459162
                                      previewInteractionTime: 0
                                      uniqueViewers: 431
                                      previewUniqueViewers: 0
                                      videoViews: 672
                                      totalVideoPercentWatched: 184.62
                                      previewVideoViews: 0
                                      previewTotalVideoPercentWatched: 0
                                    - type: 1
                                      views: 394
                                      previewViews: 3
                                      interactionTime: 4685121
                                      previewInteractionTime: 2014
                                      uniqueViewers: 128
                                      previewUniqueViewers: 1
                                      videoViews: 263
                                      totalVideoPercentWatched: 128.59
                                      previewVideoViews: 0
                                      previewTotalVideoPercentWatched: 0
                                  items:
                                    type: object
                                    properties:
                                      type:
                                        type: integer
                                        example: 0
                                      views:
                                        type: integer
                                        example: 672
                                      previewViews:
                                        type: integer
                                        example: 0
                                      interactionTime:
                                        type: integer
                                        example: 2459162
                                      previewInteractionTime:
                                        type: integer
                                        example: 0
                                      uniqueViewers:
                                        type: integer
                                        example: 431
                                      previewUniqueViewers:
                                        type: integer
                                        example: 0
                                      videoViews:
                                        type: integer
                                        example: 672
                                      totalVideoPercentWatched:
                                        type: number
                                        example: 184.62
                                      previewVideoViews:
                                        type: integer
                                        example: 0
                                      previewTotalVideoPercentWatched:
                                        type: integer
                                        example: 0
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 10055780
                          note:
                            type: string
                            example: Always
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache disabled for this endpoint
                      _rate_limits:
                        type: object
                        properties:
                          limit_minute:
                            type: integer
                            example: 5000
                          limit_day:
                            type: string
                            example: null
                            nullable: true
                          remaining_minute:
                            type: integer
                            example: 4999
                          remaining_day:
                            type: string
                            example: null
                            nullable: true
                          notice:
                            type: string
                            example: We have decided to remove our daily rate limits. Please remove any
                              references to these in your integrations.
      tags:
        - Profile Statistics
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````