> ## 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.

# Statistics Overview (/api-reference/statistics/statistics-overview)

Get an overview of statistics for fans, visitors, posts, or general.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/statistics/overview
openapi: 3.0.3
info:
  title: OnlyFans API
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: API Keys
    description: ""
  - name: Account
    description: Endpoints for your linked accounts
  - name: Analytics - Financial
    description: APIs for retrieving financial analytics data
  - name: Analytics - Summary
    description: APIs for retrieving summary analytics data
  - name: Banking
    description: Operations related to user banking details, payout methods, legal
      and tax information, and account country settings.
  - name: Chargebacks
    description: ""
  - name: Chat Messages
    description: ""
  - name: Chats
    description: ""
  - name: Client Sessions
    description: ""
  - name: Connect OnlyFans Account
    description: ""
  - name: Data Exports
    description: APIs for managing data exports
  - name: Engagement / Messages
    description: ""
  - name: Fans
    description: APIs for managing OnlyFans fans (subscribers)
  - name: Fans - AI Summary
    description: APIs for generating and retrieving AI-powered fan profile summaries
  - name: Following
    description: APIs for managing OnlyFans followings (people you're subscribed to)
  - name: Free Trial Links
    description: APIs for managing Free Trial Links
  - name: Giphy
    description: ""
  - name: Link Tags
    description: APIs for managing tags on free trial links and tracking links
  - name: Mass Messaging
    description: ""
  - name: Media
    description: ""
  - name: Media Vault
    description: ""
  - name: Media Vault Lists
    description: ""
  - name: Notifications
    description: Endpoints for managingr account notifications
  - name: Payouts
    description: ""
  - name: Post Comments
    description: ""
  - name: Post Labels
    description: APIs for managing your post labels
  - name: Posts
    description: APIs for managing OnlyFans posts
  - name: Promotions
    description: ""
  - name: Public Profiles
    description: ""
  - name: Queue
    description: ""
  - name: Release Forms
    description: APIs for managing OnlyFans release forms
  - name: Saved For Later (Messages)
    description: ""
  - name: Saved For Later (Posts)
    description: ""
  - name: Settings
    description: ""
  - name: Shared Free Trial Links
    description: APIs for Free Trial Links that other OF creators have shared with
      this account. Revenue, cost, and spender data are not available for shared
      links.
  - name: Shared Tracking Links
    description: APIs for Tracking Links (campaigns) that other OF creators have
      shared with this account. Revenue, cost, and spender data are not
      available for shared campaigns.
  - name: Smart Link Postbacks
    description: APIs for managing Smart Link postback destinations
  - name: Smart Links
    description: APIs for managing Smart Links (Free Trial Links and Tracking Links
      with pooled inventory)
  - name: Statistics
    description: ""
  - name: Stored Free Trial Links
    description: Instant APIs for retrieving stored free trial links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Free Trial Links
    description: Instant APIs for retrieving stored shared Free Trial Links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Tracking Links
    description: Instant APIs for retrieving stored shared Tracking Links
      (campaigns) from the OnlyFansAPI Cache (free, no credits used)
  - name: Stored Tracking Links
    description: Instant APIs for retrieving stored tracking links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stories
    description: APIs for managing OnlyFans stories
  - name: Story Highlights
    description: APIs for managing OnlyFans story highlights
  - name: Subscription Bundles
    description: ""
  - name: Tracking Links
    description: APIs for managing tracking links
  - name: Transactions
    description: APIs for managing OnlyFans transactions
  - name: User List Collections
    description: ""
  - name: Users
    description: APIs for fetching OnlyFans users
  - name: Webhooks
    description: ""
paths:
  /api/{account}/statistics/overview:
    parameters:
      - in: path
        name: account
        description: The Account ID
        example: acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: Statistics Overview
      operationId: statisticsOverview
      description: Get an overview of statistics for fans, visitors, posts, or general.
      parameters:
        - in: query
          name: start_date
          description: The start date for the statistics. Keep empty to retrieve from the
            model's start date.
          example: 2025-01-01 00:00:00
          required: false
          schema:
            type: string
            description: The start date for the statistics. Keep empty to retrieve from the
              model's start date.
            example: 2025-01-01 00:00:00
        - in: query
          name: end_date
          description: The end date for the statistics. Keep empty to retrieve until now.
          example: 2025-03-31 23:59:59
          required: false
          schema:
            type: string
            description: The end date for the statistics. Keep empty to retrieve until now.
            example: 2025-03-31 23:59:59
        - in: query
          name: type
          description: The type of statistics to retrieve (default = empty)
          example: fans
          required: false
          schema:
            type: string
            description: The type of statistics to retrieve (default = empty)
            example: fans
            enum:
              - fans
              - visitors
              - posts
              - messages
            nullable: true
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    earning:
                      total: 123.45
                      gross: 123.45
                      delta: 1.6
                    posts:
                      hasStatistic: true
                      count:
                        total: 123
                        delta: 0
                      views:
                        total: 123
                        delta: -7.6
                      chartData:
                        - date: 2025-01-01T00:00:00+00:00
                          count: 123
                      earnings:
                        total: 123
                        gross: 123
                        delta: 123
                    streams:
                      hasStatistic: false
                      count:
                        total: 0m
                        delta: 0
                      views:
                        total: 0
                        delta: 0
                      chartData:
                        - date: 2025-01-01T00:00:00+00:00
                          count: 123
                      earnings:
                        total: 123
                        gross: 123
                        delta: 123
                    visitors:
                      hasStatistic: true
                      visitors:
                        total: 0
                        delta: -100
                      chartData:
                        - date: 2025-01-01T00:00:00+00:00
                          count: 123
                      earnings:
                        total: 123.45
                        gross: 123.45
                        delta: -10.9
                      subscriptions:
                        new:
                          total: 123
                          delta: -5.7
                        renew:
                          total: 123
                          delta: -17
                    massMessages:
                      hasStatistic: true
                      count:
                        total: 123
                        delta: 14.5
                      views:
                        total: 0
                        delta: 0
                      chartData:
                        - date: 2025-01-01T00:00:00+00:00
                          count: 123
                      earnings:
                        total: 123.45
                        delta: -0.1
                        gross: 123.45
                  _meta:
                    _credits:
                      used: 1
                      balance: 999999254
                      note: Always
                    _cache:
                      is_cached: false
                      note: Cache disabled for this endpoint
                    _rate_limits:
                      limit_minute: 1000
                      limit_day: 50000
                      remaining_minute: 999
                      remaining_day: 49979
                properties:
                  data:
                    type: object
                    properties:
                      earning:
                        type: object
                        properties:
                          total:
                            type: number
                            example: 123.45
                          gross:
                            type: number
                            example: 123.45
                          delta:
                            type: number
                            example: 1.6
                      posts:
                        type: object
                        properties:
                          hasStatistic:
                            type: boolean
                            example: true
                          count:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 123
                              delta:
                                type: integer
                                example: 0
                          views:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 123
                              delta:
                                type: number
                                example: -7.6
                          chartData:
                            type: array
                            example:
                              - date: 2025-01-01T00:00:00+00:00
                                count: 123
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                  example: 2025-01-01T00:00:00+00:00
                                count:
                                  type: integer
                                  example: 123
                          earnings:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 123
                              gross:
                                type: integer
                                example: 123
                              delta:
                                type: integer
                                example: 123
                      streams:
                        type: object
                        properties:
                          hasStatistic:
                            type: boolean
                            example: false
                          count:
                            type: object
                            properties:
                              total:
                                type: string
                                example: 0m
                              delta:
                                type: integer
                                example: 0
                          views:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 0
                              delta:
                                type: integer
                                example: 0
                          chartData:
                            type: array
                            example:
                              - date: 2025-01-01T00:00:00+00:00
                                count: 123
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                  example: 2025-01-01T00:00:00+00:00
                                count:
                                  type: integer
                                  example: 123
                          earnings:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 123
                              gross:
                                type: integer
                                example: 123
                              delta:
                                type: integer
                                example: 123
                      visitors:
                        type: object
                        properties:
                          hasStatistic:
                            type: boolean
                            example: true
                          visitors:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 0
                              delta:
                                type: integer
                                example: -100
                          chartData:
                            type: array
                            example:
                              - date: 2025-01-01T00:00:00+00:00
                                count: 123
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                  example: 2025-01-01T00:00:00+00:00
                                count:
                                  type: integer
                                  example: 123
                          earnings:
                            type: object
                            properties:
                              total:
                                type: number
                                example: 123.45
                              gross:
                                type: number
                                example: 123.45
                              delta:
                                type: number
                                example: -10.9
                          subscriptions:
                            type: object
                            properties:
                              new:
                                type: object
                                properties:
                                  total:
                                    type: integer
                                    example: 123
                                  delta:
                                    type: number
                                    example: -5.7
                              renew:
                                type: object
                                properties:
                                  total:
                                    type: integer
                                    example: 123
                                  delta:
                                    type: integer
                                    example: -17
                      massMessages:
                        type: object
                        properties:
                          hasStatistic:
                            type: boolean
                            example: true
                          count:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 123
                              delta:
                                type: number
                                example: 14.5
                          views:
                            type: object
                            properties:
                              total:
                                type: integer
                                example: 0
                              delta:
                                type: integer
                                example: 0
                          chartData:
                            type: array
                            example:
                              - date: 2025-01-01T00:00:00+00:00
                                count: 123
                            items:
                              type: object
                              properties:
                                date:
                                  type: string
                                  example: 2025-01-01T00:00:00+00:00
                                count:
                                  type: integer
                                  example: 123
                          earnings:
                            type: object
                            properties:
                              total:
                                type: number
                                example: 123.45
                              delta:
                                type: number
                                example: -0.1
                              gross:
                                type: number
                                example: 123.45
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 999999254
                          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: 1000
                          limit_day:
                            type: integer
                            example: 50000
                          remaining_minute:
                            type: integer
                            example: 999
                          remaining_day:
                            type: integer
                            example: 49979
      tags:
        - Statistics
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````