Circana · Schema

ConsumerPurchaseRecord

Individual consumer purchase data record

AnalyticsConsumer DataMarket ResearchRetailCPGPoint Of SaleConsumer InsightsBusiness Intelligence

Properties

Name Type Description
segment string Consumer demographic segment
category string Product category name
penetration_pct number Category penetration percentage
buy_rate number Average purchase frequency
avg_spend number Average spend per buyer
trips_per_buyer number Average shopping trips per buyer
channel string Retail channel
View JSON Schema on GitHub

JSON Schema

liquid-data-consumer-purchase-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-consumer-purchase-record-schema.json",
  "title": "ConsumerPurchaseRecord",
  "description": "Individual consumer purchase data record",
  "type": "object",
  "properties": {
    "segment": {
      "type": "string",
      "description": "Consumer demographic segment",
      "example": "18-34"
    },
    "category": {
      "type": "string",
      "description": "Product category name",
      "example": "Beverages"
    },
    "penetration_pct": {
      "type": "number",
      "format": "double",
      "description": "Category penetration percentage",
      "example": 72.5
    },
    "buy_rate": {
      "type": "number",
      "format": "double",
      "description": "Average purchase frequency",
      "example": 3.2
    },
    "avg_spend": {
      "type": "number",
      "format": "double",
      "description": "Average spend per buyer",
      "example": 15.80
    },
    "trips_per_buyer": {
      "type": "number",
      "format": "double",
      "description": "Average shopping trips per buyer",
      "example": 4.1
    },
    "channel": {
      "type": "string",
      "description": "Retail channel",
      "example": "grocery"
    }
  }
}