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

# Product intelligence

> How Nektir turns terse DABS labels and taxonomy into conservative, filterable product attributes.

Nektir enriches product records during ingestion so API reads remain fast. Product intelligence v2 adds normalized wine varietals, beverage styles, source-taxonomy country codes, and alcohol by volume when the source provides enough evidence.

```json theme={"dark"}
{
  "attributes": {
    "vintage_year": 2022,
    "proof": null,
    "alcohol_by_volume_percent": null,
    "alcohol_by_volume_basis": null,
    "package_form": null,
    "wine_varietals": ["sauvignon_blanc"],
    "beverage_styles": [],
    "origin_country_codes": ["NZ"],
    "production_designations": [],
    "certifications": [],
    "source_programs": []
  }
}
```

## Evidence policy

* A name-derived value requires explicit, context-constrained wording.
* A taxonomy-derived value requires an unambiguous DABS class. Grouped classes such as “Syrah, Petite Sirah” do not assign either varietal without name evidence.
* `alcohol_by_volume_percent` is either explicitly labeled or exactly `proof / 2`; `alcohol_by_volume_basis` tells you which.
* Country codes are emitted only when one country is explicit in the DABS class name. They describe the source taxonomy, not independently verified production or bottling origin.
* An empty array or `null` means “not established.” It does not mean the characteristic is absent.

The raw DABS label and taxonomy remain available on product detail under `source_fields`. Editorial overrides can correct public names and name components without altering source evidence.

## Filter products

Use comma-separated values with `wine_varietals`, `beverage_styles`, `origin_country_codes`, or `production_designations`. Values within one parameter use OR semantics; different filter parameters combine with AND semantics.

```bash theme={"dark"}
curl "http://127.0.0.1:5185/v1/products?wine_varietals=pinot_noir&origin_country_codes=FR&limit=25"
```

Read the current values and display labels from `data.product_intelligence.filters` in `/v1/meta`; do not hard-code them into a browsing interface.

## Known limits

DABS does not currently expose broad UPC, ABV, producer, ownership, or verified geographic-origin fields through the observed public catalog sources. Nektir therefore leaves those values unresolved unless explicit evidence exists. Product intelligence improves presentation and filtering; it is not a claim of manufacturer-verified product specifications.