Circana · Schema

MarketShareRecord

Individual market share data record

AnalyticsConsumer DataMarket ResearchRetailCPGPoint Of SaleConsumer InsightsBusiness Intelligence

Properties

Name Type Description
brand string Brand name
dollar_share number Dollar market share percentage
unit_share number Unit market share percentage
share_change number Share change vs prior period in percentage points
period string Time period identifier
View JSON Schema on GitHub

JSON Schema

circana-marketsharerecord-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/MarketShareRecord",
  "title": "MarketShareRecord",
  "type": "object",
  "description": "Individual market share data record",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand name",
      "example": "Example Brand A"
    },
    "dollar_share": {
      "type": "number",
      "format": "double",
      "description": "Dollar market share percentage",
      "example": 24.5
    },
    "unit_share": {
      "type": "number",
      "format": "double",
      "description": "Unit market share percentage",
      "example": 22.1
    },
    "share_change": {
      "type": "number",
      "format": "double",
      "description": "Share change vs prior period in percentage points",
      "example": 1.2
    },
    "period": {
      "type": "string",
      "description": "Time period identifier",
      "example": "2026-Q1"
    }
  }
}