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

# Seller website sessions

> Session detail for the Website scope of one seller owned by the authenticated organization: site sessions by country with how many reached the storefront, the most walked page paths, and the sessions that reached the storefront with the storefront journey each became. Optional tier and agentType filters narrow the sessions; entryPage narrows them to the sessions that started on one page.



## OpenAPI

````yaml https://api.zeroclick.io/openapi.json get /v1/analytics/sellers/{sellerId}/website-sessions
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}/website-sessions:
    get:
      tags:
        - Analytics
      summary: Seller website sessions
      description: >-
        Session detail for the Website scope of one seller owned by the
        authenticated organization: site sessions by country with how many
        reached the storefront, the most walked page paths, and the sessions
        that reached the storefront with the storefront journey each became.
        Optional tier and agentType filters narrow the sessions; entryPage
        narrows them to the sessions that started on one page.
      parameters:
        - schema:
            default: 30
            anyOf:
              - type: string
                enum:
                  - all
              - type: integer
                minimum: 1
                maximum: 365
          in: query
          name: days
          required: false
        - schema:
            type: string
            enum:
              - verified
              - unverified
          in: query
          name: tier
          required: false
        - schema:
            type: string
            enum:
              - ai_assistants
              - crawlers
              - browser_agents
              - automation
              - unclassified
          in: query
          name: agentType
          required: false
        - schema:
            type: string
            minLength: 1
            maxLength: 512
            pattern: ^\/.*
          in: query
          name: entryPage
          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:
                      days:
                        type: number
                      agentSessions:
                        type: number
                      regions:
                        type: array
                        items:
                          type: object
                          properties:
                            country:
                              type: string
                            sessions:
                              type: number
                            share:
                              type: number
                            reached:
                              type: number
                          required:
                            - country
                            - sessions
                            - share
                            - reached
                          additionalProperties: false
                      unresolvedSessions:
                        type: number
                      paths:
                        type: array
                        items:
                          type: object
                          properties:
                            route:
                              type: array
                              items:
                                type: string
                            sessions:
                              type: number
                            reached:
                              type: number
                          required:
                            - route
                            - sessions
                            - reached
                          additionalProperties: false
                      missingPages:
                        type: array
                        items:
                          type: string
                      sessions:
                        type: array
                        items:
                          type: object
                          properties:
                            sessionKey:
                              type: string
                            startedAt:
                              type: string
                            agent:
                              type: string
                            agentType:
                              type: string
                            agentTypeLabel:
                              type: string
                            tier:
                              type: string
                            country:
                              nullable: true
                              type: string
                            route:
                              type: array
                              items:
                                type: string
                            storefrontSessionKey:
                              nullable: true
                              type: string
                            storefrontJourney:
                              type: array
                              items:
                                type: string
                            converted:
                              type: boolean
                            revenueUsd:
                              type: string
                            outcome:
                              type: string
                          required:
                            - sessionKey
                            - startedAt
                            - agent
                            - agentType
                            - agentTypeLabel
                            - tier
                            - country
                            - route
                            - storefrontSessionKey
                            - storefrontJourney
                            - converted
                            - revenueUsd
                            - outcome
                          additionalProperties: false
                    required:
                      - days
                      - agentSessions
                      - regions
                      - unresolvedSessions
                      - paths
                      - missingPages
                      - sessions
                    additionalProperties: false
                required:
                  - sessions
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - organization_permission_required
                      - seller_not_found
                      - service_not_found
                      - meter_not_found
                      - plan_not_found
                      - plan_meter_price_not_found
                      - duplicate_slug
                      - duplicate_key
                      - duplicate_plan_meter_price
                      - duplicate_free_trial
                      - signing_secret_not_found
                      - insufficient_scope
                      - payg_price_not_whole_cents
                      - custom_domain_skip_unavailable
                      - active_stateful_accounts_exist
                      - free_trial_price_not_zero
                      - free_trial_interval_not_none
                      - included_credit_units_incomplete
                      - included_credit_units_without_credit
                      - claim_cap_requires_free_trial
                      - maximum_purchase_below_minimum
                      - buy_with_ai_not_available
                required:
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - organization_permission_required
                      - seller_not_found
                      - service_not_found
                      - meter_not_found
                      - plan_not_found
                      - plan_meter_price_not_found
                      - duplicate_slug
                      - duplicate_key
                      - duplicate_plan_meter_price
                      - duplicate_free_trial
                      - signing_secret_not_found
                      - insufficient_scope
                      - payg_price_not_whole_cents
                      - custom_domain_skip_unavailable
                      - active_stateful_accounts_exist
                      - free_trial_price_not_zero
                      - free_trial_interval_not_none
                      - included_credit_units_incomplete
                      - included_credit_units_without_credit
                      - claim_cap_requires_free_trial
                      - maximum_purchase_below_minimum
                      - buy_with_ai_not_available
                required:
                  - error
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - organization_permission_required
                      - seller_not_found
                      - service_not_found
                      - meter_not_found
                      - plan_not_found
                      - plan_meter_price_not_found
                      - duplicate_slug
                      - duplicate_key
                      - duplicate_plan_meter_price
                      - duplicate_free_trial
                      - signing_secret_not_found
                      - insufficient_scope
                      - payg_price_not_whole_cents
                      - custom_domain_skip_unavailable
                      - active_stateful_accounts_exist
                      - free_trial_price_not_zero
                      - free_trial_interval_not_none
                      - included_credit_units_incomplete
                      - included_credit_units_without_credit
                      - claim_cap_requires_free_trial
                      - maximum_purchase_below_minimum
                      - buy_with_ai_not_available
                required:
                  - error
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - organization_required
                      - organization_permission_required
                      - seller_not_found
                      - service_not_found
                      - meter_not_found
                      - plan_not_found
                      - plan_meter_price_not_found
                      - duplicate_slug
                      - duplicate_key
                      - duplicate_plan_meter_price
                      - duplicate_free_trial
                      - signing_secret_not_found
                      - insufficient_scope
                      - payg_price_not_whole_cents
                      - custom_domain_skip_unavailable
                      - active_stateful_accounts_exist
                      - free_trial_price_not_zero
                      - free_trial_interval_not_none
                      - included_credit_units_incomplete
                      - included_credit_units_without_credit
                      - claim_cap_requires_free_trial
                      - maximum_purchase_below_minimum
                      - buy_with_ai_not_available
                required:
                  - error
                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_...`.

````