Skip to main content
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.

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 public name is a consumer display title. When Nektir has resolved the brand, the title omits that brand; it also omits structured volume and pack-count suffixes. Use brand and package_size to compose the presentation your application needs. Package metadata separates container_count, unit_milliliters, and total_milliliters; check interpretation before using calculated dimensions. The legacy milliliters value remains for v1 compatibility but can have ambiguous multipack semantics. If the brand is unresolved, its source text remains in name rather than being guessed away. The raw DABS label and taxonomy remain available on product detail under source_fields. Editorial overrides can correct public names, name components, and supported intelligence values without altering source evidence. A non-null review states whether an owner confirmed the deterministic output or published a correction. alcohol_by_volume_basis: editorial_review distinguishes reviewed ABV from a source label or proof-derived value. Reviewed corrections are auditable and immediately republished. They never alter price, status, inventory, raw DABS fields, or the three source/retrieval/publication clocks.

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.
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.