> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt > Use this file to discover all available pages before exploring further. # Get Growth Overview > Sales, traffic, and profit KPIs with their change against the previous period, a daily trend, the traffic funnel, sales by channel, top and lagging products, and ranked next actions. Matches the Growth Intelligence overview page. Requires `analytics:read`. Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days. ## OpenAPI ````yaml /openapi.json get /api/v1/analytics/overview openapi: 3.1.0 info: title: OmniCommerce API version: 1.0.0 license: name: Proprietary url: https://omnicommerce.sg/terms description: >- OmniCommerce API surface for agents and developer integrations. Includes public endpoints (merchant discovery, product search, compare, catalog, ACO retrieval) and authenticated endpoints (product management via API key Bearer tokens). servers: - url: https://omnicommerce.sg description: Production - url: http://localhost:3000 description: Local development security: [] tags: - name: agentic-checkout description: Merchant-fulfilled agentic checkout x-group: Agentic Checkout - name: agents description: agents x-group: Agents - name: analytics description: Sales performance across marketplaces x-group: Analytics - name: aops description: Agent operating procedures x-group: AOPs - name: campaigns description: Campaign briefs, offer windows, and marketplace runs x-group: Campaigns - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: looks description: AI-styled product looks x-group: Looks - name: oauth description: OAuth token endpoints x-group: OAuth - name: orders description: Workspace and agentic orders x-group: Orders - name: organizations description: Organization management x-group: Organizations - name: price-books description: Marketplace list-price markup rules x-group: Price Books - name: products description: Product CRUD, bulk import, enrichment, publish, and delist x-group: Products - name: promotions description: Central promotions and marketplace sync x-group: Promotions - name: public-agent description: Public agent discovery and catalog APIs x-group: Public Agent - name: returns description: returns x-group: Returns - name: reviews description: Marketplace product reviews and seller replies x-group: Reviews - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/analytics/overview: get: tags: - analytics summary: Get Growth Overview description: >- Sales, traffic, and profit KPIs with their change against the previous period, a daily trend, the traffic funnel, sales by channel, top and lagging products, and ranked next actions. Matches the Growth Intelligence overview page. Requires `analytics:read`. Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days. operationId: get_v1_analytics_overview parameters: - name: organizationId in: query required: false description: >- Required for session auth. API keys already belong to one organization. schema: type: string maxLength: 160 - name: from in: query required: false description: >- First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: to in: query required: false description: Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: timeZone in: query required: false description: >- IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. schema: type: string maxLength: 80 - name: marketplace in: query required: false description: Comma-separated marketplaces, for example `shopee,lazada`. schema: type: string maxLength: 200 - name: country in: query required: false description: Comma-separated countries. One country selects its currency. schema: type: string maxLength: 200 - name: store in: query required: false description: >- Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. schema: type: string maxLength: 1000 - name: currency in: query required: false description: >- ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. schema: type: string maxLength: 3 responses: '200': description: Get Growth Overview content: application/json: schema: type: object properties: ok: type: boolean apiVersion: type: string const: developer_v1 operationId: type: string status: type: string enum: - accepted - completed - failed jobId: type: string productId: type: string warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object propertyNames: type: string additionalProperties: type: string data: type: object properties: filters: type: object properties: from: type: string to: type: string marketplace: type: string country: type: string store: type: string currency: type: string description: Currency of every amount in the response. timeZone: type: string required: - from - to - marketplace - country - store - currency - timeZone previousFrom: type: string previousTo: type: string marketplaceScope: type: string description: >- `all`, or the single marketplace reported. With one marketplace, `channelMix` is split by store. kpis: type: object properties: grossSales: type: number grossSalesChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. netSales: type: number netSalesChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. orders: type: integer minimum: -9007199254740991 maximum: 9007199254740991 ordersChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. unitsSold: type: number unitsChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. aov: anyOf: - type: number - type: 'null' aovChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. unitsPerOrder: anyOf: - type: number - type: 'null' unitsPerOrderChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. visitors: anyOf: - type: number - type: 'null' pageviews: anyOf: - type: number - type: 'null' atcUsers: anyOf: - type: number - type: 'null' description: Visitors who added to cart. viewToOrderCvr: anyOf: - type: number - type: 'null' contributionProfit: anyOf: - type: number - type: 'null' adsSpend: anyOf: - type: number - type: 'null' required: - grossSales - grossSalesChangePercent - netSales - netSalesChangePercent - orders - ordersChangePercent - unitsSold - unitsChangePercent - aov - aovChangePercent - unitsPerOrder - unitsPerOrderChangePercent - visitors - pageviews - atcUsers - viewToOrderCvr - contributionProfit - adsSpend dailyTrend: type: array items: type: object properties: date: type: string grossSales: type: number netSales: type: number orders: type: integer minimum: -9007199254740991 maximum: 9007199254740991 unitsSold: type: number aov: anyOf: - type: number - type: 'null' unitsPerOrder: anyOf: - type: number - type: 'null' visitors: anyOf: - type: number - type: 'null' pageviews: anyOf: - type: number - type: 'null' required: - date - grossSales - netSales - orders - unitsSold - aov - unitsPerOrder - visitors - pageviews funnel: type: array items: type: object properties: id: type: string label: type: string value: anyOf: - type: number - type: 'null' covered: type: boolean required: - id - label - value - covered channelMix: type: array items: type: object properties: platform: type: string accountId: anyOf: - type: string - type: 'null' label: type: string netSales: type: number orders: type: integer minimum: -9007199254740991 maximum: 9007199254740991 unitsSold: type: number changePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. required: - platform - accountId - label - netSales - orders - unitsSold - changePercent topProducts: type: array items: type: object properties: productId: anyOf: - type: string - type: 'null' variantId: anyOf: - type: string - type: 'null' sku: anyOf: - type: string - type: 'null' productName: type: string thumbnailUrl: anyOf: - type: string - type: 'null' platform: anyOf: - type: string - type: 'null' accountId: anyOf: - type: string - type: 'null' externalProductId: anyOf: - type: string - type: 'null' netSales: type: number orders: type: integer minimum: -9007199254740991 maximum: 9007199254740991 unitsSold: type: number revenueShare: type: number description: Share of net sales, 0 to 1. gmvChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. required: - productId - variantId - sku - productName - thumbnailUrl - platform - accountId - externalProductId - netSales - orders - unitsSold - revenueShare - gmvChangePercent laggingProducts: type: array items: type: object properties: productId: anyOf: - type: string - type: 'null' variantId: anyOf: - type: string - type: 'null' sku: anyOf: - type: string - type: 'null' productName: type: string thumbnailUrl: anyOf: - type: string - type: 'null' platform: anyOf: - type: string - type: 'null' accountId: anyOf: - type: string - type: 'null' externalProductId: anyOf: - type: string - type: 'null' netSales: type: number orders: type: integer minimum: -9007199254740991 maximum: 9007199254740991 unitsSold: type: number revenueShare: type: number description: Share of net sales, 0 to 1. gmvChangePercent: anyOf: - type: number - type: 'null' description: >- Change against the previous period of equal length. Null without a baseline. required: - productId - variantId - sku - productName - thumbnailUrl - platform - accountId - externalProductId - netSales - orders - unitsSold - revenueShare - gmvChangePercent insights: type: array items: type: object properties: id: type: string code: type: string severity: type: string enum: - info - warn - critical - opportunity category: type: string enum: - conversion - profit - inventory - ads - growth - data - market - pricing title: type: string summary: type: string impactLabel: type: string impactScore: type: number description: 0 to 100, higher first. productId: anyOf: - type: string - type: 'null' productName: anyOf: - type: string - type: 'null' required: - id - code - severity - category - title - summary - impactLabel - impactScore - productId - productName description: Ranked next actions. coverage: type: object properties: sales: type: boolean traffic: type: boolean ads: type: boolean content: type: boolean inventory: type: boolean profit: type: boolean market: type: boolean required: - sales - traffic - ads - content - inventory - profit - market description: Which data sources have data for this range. syncFreshness: type: array items: type: object properties: jobType: type: string platform: anyOf: - type: string - type: 'null' accountId: anyOf: - type: string - type: 'null' status: type: string completedAt: anyOf: - type: string - type: 'null' rowsUpserted: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - jobType - platform - accountId - status - completedAt - rowsUpserted required: - filters - previousFrom - previousTo - marketplaceScope - kpis - dailyTrend - funnel - channelMix - topProducts - laggingProducts - insights - coverage - syncFreshness required: - ok - apiVersion - operationId - status - warnings - recommendations - links - data '400': description: Invalid request '401': description: Unauthorized '403': description: Missing the `analytics:read` scope '429': description: Rate limit exceeded '500': description: Internal Server Error security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.