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

# V3 session and visitor facts

> Full-population session/visitor metrics and a stable ordered page of sessions for an inclusive UTC date range. Identity, unmatched and outcome filters narrow the list only. Repeat with offset to export all rows. Daily unique visitors are non-additive across days. Returns 503 until the new data contract is ready.



## OpenAPI

````yaml https://api.zeroclick.io/openapi.json get /v1/analytics/sellers/{sellerId}/session-facts
openapi: 3.0.0
info:
  title: ZeroClick API
  description: >-
    REST API for managing ZeroClick sellers, services, pricing, usage, and
    analytics. Authenticate with an API key from the ZeroClick dashboard.
  version: 1.0.0
servers:
  - url: https://api.zeroclick.io
security:
  - bearerAuth: []
tags:
  - name: API keys
  - name: Sellers
  - name: Services
  - name: Meters
  - name: Plans
  - name: Plan meter prices
  - name: Usage
  - name: Analytics
  - name: Agentify
  - name: Stripe Connect
  - name: Sandbox
  - name: Organizations
  - name: Users
paths:
  /v1/analytics/sellers/{sellerId}/session-facts:
    get:
      tags:
        - Analytics
      summary: V3 session and visitor facts
      description: >-
        Full-population session/visitor metrics and a stable ordered page of
        sessions for an inclusive UTC date range. Identity, unmatched and
        outcome filters narrow the list only. Repeat with offset to export all
        rows. Daily unique visitors are non-additive across days. Returns 503
        until the new data contract is ready.
      parameters:
        - schema:
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
          in: query
          name: startDate
          required: true
        - schema:
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
          in: query
          name: endDate
          required: true
        - schema:
            type: string
            minLength: 1
            maxLength: 80
          in: query
          name: asOf
          required: false
        - schema:
            default: 50
            type: integer
            minimum: 1
            maximum: 1000
          in: query
          name: limit
          required: false
        - schema:
            default: 0
            type: integer
            minimum: 0
            maximum: 9007199254740991
          in: query
          name: offset
          required: false
        - schema:
            default: storefront
            type: string
            enum:
              - storefront
              - website
          in: query
          name: scope
          required: false
        - schema:
            default: visitors
            type: string
            enum:
              - sessions
              - visitors
          in: query
          name: counting
          required: false
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: hideBots
          required: false
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: hideInternal
          required: false
        - schema:
            type: string
          in: query
          name: agentTypes
          required: false
        - schema:
            anyOf:
              - type: string
                enum:
                  - unknown
              - type: string
                pattern: ^[A-Z]{2}$
          in: query
          name: country
          required: false
        - schema:
            type: string
            minLength: 1
            maxLength: 256
          in: query
          name: identity
          required: false
        - schema:
            default: exact
            type: string
            enum:
              - exact
              - prefix
          in: query
          name: identityMatch
          required: false
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: unmatchedOnly
          required: false
        - schema:
            type: string
            enum:
              - converted_paid
              - converted_trial
              - bought_unused
              - handed_off
              - quoted
              - browsed
              - left
              - reached
              - shown_link
          in: query
          name: outcome
          required: false
        - schema:
            type: string
            minLength: 1
          in: path
          name: sellerId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  sessions:
                    type: object
                    properties:
                      asOf:
                        type: string
                      marketingConfigured:
                        type: boolean
                      scope:
                        type: string
                        enum:
                          - storefront
                          - website
                      counting:
                        type: string
                        enum:
                          - sessions
                          - visitors
                      startDate:
                        type: string
                      endDate:
                        type: string
                      totals: {}
                      flow:
                        type: array
                        items:
                          type: object
                          properties:
                            entry:
                              nullable: true
                              type: string
                            outcome:
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - entry
                            - outcome
                            - count
                          additionalProperties: false
                      outcomes:
                        type: array
                        items:
                          type: object
                          properties:
                            outcome:
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - outcome
                            - count
                          additionalProperties: false
                      daily:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            outcome:
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - date
                            - outcome
                            - count
                          additionalProperties: false
                      types:
                        type: array
                        items: {}
                      regions:
                        type: array
                        items:
                          type: object
                          properties:
                            country:
                              nullable: true
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - country
                            - count
                          additionalProperties: false
                      total:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      limit:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      offset:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      rows:
                        type: array
                        items: {}
                      journeyLinks:
                        type: array
                        items: {}
                    required:
                      - asOf
                      - marketingConfigured
                      - scope
                      - counting
                      - startDate
                      - endDate
                      - totals
                      - flow
                      - outcomes
                      - daily
                      - types
                      - regions
                      - total
                      - limit
                      - offset
                      - rows
                      - journeyLinks
                    additionalProperties: false
                required:
                  - sessions
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key created in the ZeroClick dashboard under Settings → API keys.
        Keys start with `zc_`. Send them as `Authorization: Bearer zc_...`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.