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

liquid-data-market-share-record-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/circana/refs/heads/main/json-schema/liquid-data-market-share-record-schema.json",
  "title": "MarketShareRecord",
  "description": "Individual market share data record",
  "type": "object",
  "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"
    }
  }
}