Circana · Schema
POSRecord
Individual point-of-sale data record
AnalyticsConsumer DataMarket ResearchRetailCPGPoint Of SaleConsumer InsightsBusiness Intelligence
Properties
| Name | Type | Description |
|---|---|---|
| period | string | Time period identifier |
| category | string | Product category name |
| brand | string | Brand name |
| upc | string | Universal Product Code |
| dollar_sales | number | Total dollar sales for the period |
| unit_sales | integer | Total unit sales for the period |
| volume_sales | number | Total volume sales (equivalent units) |
| avg_price | number | Average selling price |
| distribution_pct | number | Percentage of stores carrying the product |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/POSRecord",
"title": "POSRecord",
"type": "object",
"description": "Individual point-of-sale data record",
"properties": {
"period": {
"type": "string",
"description": "Time period identifier",
"example": "2026-W01"
},
"category": {
"type": "string",
"description": "Product category name",
"example": "Beverages"
},
"brand": {
"type": "string",
"description": "Brand name",
"example": "Example Brand"
},
"upc": {
"type": "string",
"description": "Universal Product Code",
"example": "012345678901"
},
"dollar_sales": {
"type": "number",
"format": "double",
"description": "Total dollar sales for the period",
"example": 125340.5
},
"unit_sales": {
"type": "integer",
"description": "Total unit sales for the period",
"example": 45230
},
"volume_sales": {
"type": "number",
"format": "double",
"description": "Total volume sales (equivalent units)",
"example": 67845.0
},
"avg_price": {
"type": "number",
"format": "double",
"description": "Average selling price",
"example": 2.77
},
"distribution_pct": {
"type": "number",
"format": "double",
"description": "Percentage of stores carrying the product",
"example": 85.3
}
}
}