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

# V3 store demand

> Per-service demand for one seller over an inclusive UTC date range: for each live service (or the one named by serviceId), the eligible storefront sessions that opened its page (a floor: an agent that reads the whole catalog at once opens none), the 402 quotes minted on it (one per challenged payment, read from the raw event stream, which the bot and internal switches cannot reach), its verified per-call payments and their sum, the requests and dollars its calls drew on plan credit, the completed free-trial and free-mode calls it served, and where that puts it on the demand ladder. Returns 503 until the marts behind it exist.



## OpenAPI

````yaml https://api.zeroclick.io/openapi.json get /v1/analytics/sellers/{sellerId}/store-demand
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}/store-demand:
    get:
      tags:
        - Analytics
      summary: V3 store demand
      description: >-
        Per-service demand for one seller over an inclusive UTC date range: for
        each live service (or the one named by serviceId), the eligible
        storefront sessions that opened its page (a floor: an agent that reads
        the whole catalog at once opens none), the 402 quotes minted on it (one
        per challenged payment, read from the raw event stream, which the bot
        and internal switches cannot reach), its verified per-call payments and
        their sum, the requests and dollars its calls drew on plan credit, the
        completed free-trial and free-mode calls it served, and where that puts
        it on the demand ladder. 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:
            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
            minLength: 1
          in: query
          name: serviceId
          required: false
        - schema:
            type: string
            minLength: 1
            maxLength: 80
          in: query
          name: asOf
          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:
                  demand:
                    type: object
                    properties:
                      asOf:
                        type: string
                      window:
                        type: object
                        properties:
                          startDate:
                            type: string
                          endDate:
                            type: string
                        required:
                          - startDate
                          - endDate
                        additionalProperties: false
                      filters:
                        type: object
                        properties:
                          hideBots:
                            type: boolean
                          hideInternal:
                            type: boolean
                          serviceId:
                            nullable: true
                            type: string
                        required:
                          - hideBots
                          - hideInternal
                          - serviceId
                        additionalProperties: false
                      services:
                        type: array
                        items:
                          type: object
                          properties:
                            serviceId:
                              type: string
                            slug:
                              type: string
                            name:
                              type: string
                            viewedSessions:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            quotes:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            payments:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            paidCalls:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            revenueUsd: {}
                            creditRequests:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            creditUsd: {}
                            freeCalls:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            status:
                              type: string
                              enum:
                                - converting
                                - quoted
                                - read
                                - quiet
                          required:
                            - serviceId
                            - slug
                            - name
                            - viewedSessions
                            - quotes
                            - payments
                            - paidCalls
                            - revenueUsd
                            - creditRequests
                            - creditUsd
                            - freeCalls
                            - status
                          additionalProperties: false
                    required:
                      - asOf
                      - window
                      - filters
                      - services
                    additionalProperties: false
                required:
                  - demand
                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.