> ## 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 or visitor metrics for an inclusive UTC date range (totals with the previous window, outcomes, daily outcomes and chart splits, the seven traffic types, regions, top routes, first and last documents, the arrival-lane flow) and one stable ordered page of sessions. Page-wide filters change every number; list filters narrow the rows and their outcome chips only. Daily unique visitors are non-additive across days. Repeat with offset and the first page's asOf to export every row. Returns 503 until the marts behind it exist.



## 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 or visitor metrics for an inclusive UTC date
        range (totals with the previous window, outcomes, daily outcomes and
        chart splits, the seven traffic types, regions, top routes, first and
        last documents, the arrival-lane flow) and one stable ordered page of
        sessions. Page-wide filters change every number; list filters narrow the
        rows and their outcome chips only. Daily unique visitors are
        non-additive across days. Repeat with offset and the first page's asOf
        to export every row. Returns 503 until the marts behind it exist.
      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:
            default: previous
            type: string
            enum:
              - previous
              - none
          in: query
          name: compare
          required: false
        - 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: sessions
            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
            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
            maxLength: 1024
          in: query
          name: entry
          required: false
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
          in: query
          name: entryMissing
          required: false
        - schema:
            type: string
            enum:
              - website_markdown
              - website_static
              - other_tagged
              - untagged
              - website
          in: query
          name: placement
          required: false
        - schema:
            type: string
            enum:
              - converted_paid
              - converted_trial
              - bought_unused
              - handed_off
              - quoted
              - browsed
              - left
              - reached
              - shown_link
          in: query
          name: listOutcome
          required: false
        - schema:
            anyOf:
              - type: string
                enum:
                  - unknown
              - type: string
                pattern: ^[A-Z]{2}$
          in: query
          name: listCountry
          required: false
        - schema:
            type: string
          in: query
          name: listAgentTypes
          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
            minLength: 1
            maxLength: 256
          in: query
          name: sessionKey
          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
                      window:
                        type: object
                        properties:
                          startDate:
                            type: string
                          endDate:
                            type: string
                        required:
                          - startDate
                          - endDate
                        additionalProperties: false
                      previousWindow:
                        nullable: true
                        type: object
                        properties:
                          startDate:
                            type: string
                          endDate:
                            type: string
                        required:
                          - startDate
                          - endDate
                        additionalProperties: false
                      filters:
                        type: object
                        properties:
                          hideBots:
                            type: boolean
                          hideInternal:
                            type: boolean
                          agentTypes:
                            nullable: true
                            type: array
                            items:
                              type: string
                          country:
                            nullable: true
                            type: string
                          outcome:
                            nullable: true
                            type: string
                          entry:
                            nullable: true
                            type: array
                            items:
                              type: string
                          entryMissing:
                            type: boolean
                          placement:
                            nullable: true
                            type: string
                          listOutcome:
                            nullable: true
                            type: string
                          listCountry:
                            nullable: true
                            type: string
                          listAgentTypes:
                            nullable: true
                            type: array
                            items:
                              type: string
                          identity:
                            nullable: true
                            type: string
                          identityMatch:
                            type: string
                            enum:
                              - exact
                              - prefix
                          unmatchedOnly:
                            type: boolean
                          sessionKey:
                            nullable: true
                            type: string
                        required:
                          - hideBots
                          - hideInternal
                          - agentTypes
                          - country
                          - outcome
                          - entry
                          - entryMissing
                          - placement
                          - listOutcome
                          - listCountry
                          - listAgentTypes
                          - identity
                          - identityMatch
                          - unmatchedOnly
                          - sessionKey
                        additionalProperties: false
                      totals: {}
                      previousTotals:
                        nullable: true
                      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
                      agentTypes: {}
                      regions:
                        type: array
                        items:
                          type: object
                          properties:
                            country:
                              nullable: true
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            converted:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - country
                            - count
                            - converted
                          additionalProperties: false
                      platforms:
                        type: array
                        items:
                          type: object
                          properties:
                            platform:
                              nullable: true
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - platform
                            - count
                          additionalProperties: false
                      routes:
                        type: array
                        items: {}
                      documents:
                        type: array
                        items:
                          type: object
                          properties:
                            position:
                              type: string
                              enum:
                                - first
                                - last
                            document:
                              nullable: true
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - position
                            - document
                            - count
                          additionalProperties: false
                      breakdowns:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            dimension:
                              type: string
                              enum:
                                - agent_type
                                - entry
                                - country
                            value:
                              nullable: true
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - date
                            - dimension
                            - value
                            - count
                          additionalProperties: false
                      placements:
                        type: array
                        items: {}
                      listOutcomes:
                        type: array
                        items:
                          type: object
                          properties:
                            outcome:
                              type: string
                            count:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                          required:
                            - outcome
                            - 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: {}
                    required:
                      - asOf
                      - marketingConfigured
                      - scope
                      - counting
                      - window
                      - previousWindow
                      - filters
                      - totals
                      - previousTotals
                      - outcomes
                      - daily
                      - agentTypes
                      - regions
                      - platforms
                      - routes
                      - documents
                      - breakdowns
                      - placements
                      - listOutcomes
                      - total
                      - limit
                      - offset
                      - rows
                    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.