> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Product analytics

> Retrieve item volume, average items per order, best sellers, and location product trends.

```text Location theme={null}
GET /v1/locations/{location_id}/analytics/products
```

```text Business organization theme={null}
GET /v1/organizations/{organization_id}/analytics/products
```

## Statistics

| Field                                | Scope    | Meaning                                                                                |
| ------------------------------------ | -------- | -------------------------------------------------------------------------------------- |
| `sold_item_count`                    | Both     | Standalone products and bundles sold. Each bundle counts as one sold item.             |
| `average_items_per_order`            | Location | Average menu-item quantity per order, including items contained in bundles.            |
| `top_products[].quantity`            | Both     | Quantity sold for a best-selling standalone product or bundle.                         |
| `daily_top_product_sales[].quantity` | Location | Quantity sold on one local date for one of the period's three best-selling menu items. |

The daily trend uses long-form rows with `date`, `product_name`, and `quantity`. This schema remains stable even when the best-selling products change.

```json Location response excerpt theme={null}
{
  "summary": {
    "sold_item_count": 910,
    "average_items_per_order": 2.8
  },
  "top_products": [{ "name": "Salmon bowl", "quantity": 86 }],
  "daily_top_product_sales": [
    { "date": "2026-06-01", "product_name": "Salmon bowl", "quantity": 8 }
  ]
}
```

Product names are snapshots from orders, so historical values remain meaningful if the current menu later changes a name or removes an item.
