Open standardv0.1.0

The WineGraph Open Data Model

Name: WineGraph Open Data Model
Creator: WineGraph
License: https://opendatacommons.org/licenses/odbl/

One canonical model for the wine trade. Producer → wine → vintage → SKU, joined to who imports, distributes, and pours it, with the source behind every field.

Building a wine site, or moving data between layers of the trade? Adopt this model, publish to it, and plug into the graph. It is the same model WineGraph runs in production: open, versioned, and machine-readable. The spec is free to use. Entity resolution and the resolved corpus are the hosted product.

Machine-readable

Artifacts

JSON Schemaschema+json JSON-LD contextld+json OpenAPI (the /v1 API)openapi Discovery descriptor.well-known

The model

Entities

Supply — producers & wines

producerProducer

A winery / estate / négociant that makes wine.

founded · sizeHa · farming · philosophy

skuWine (SKU)

A specific bottling — the canonical wine unit. Producer + cuvée + vintage + format.

wine.color · wine.sparkling · wine.grapes · wine.farming · wine.abv · wine.appellation · facets

vintageVintage

A vintage-level grouping (optional intermediate between wine and SKU).

brandBrand

A commercial brand spanning bottlings.

Trade — importers & distributors

importerImporter

A US importer of record (TTB permit holder).

org.permit · org.dba

distributorDistributor

A wholesaler / distributor (state-licensed).

Demand — shops & restaurants

retailerWine Shop

An off-premise retailer.

geo · web

restaurantRestaurant

An on-premise venue with a wine list.

geo · web

Reference — regions, grapes, places, terms

regionRegion

A wine region / appellation with content + hierarchy.

reference.slug* · reference.content · reference.parentSlug

grapeGrape

A grape variety with content.

reference.slug* · reference.content

placePlace

A town / site / landmark.

reference.slug*

termTerm

A glossary concept / technique / classification.

reference.slug*

Accolades — critics, awards, publications

awardAward

A discrete honor (Michelin star, Wine Spectator Grand Award, …).

accolade.issuer* · accolade.scale

criticCritic

A wine/restaurant critic or critic-outlet.

accolade.issuer

publicationPublication

An editorial outlet (reviews, lists).

accolade.issuer

The graph

Relationships

producesproducer → skuA producer makes a wine.

importsimporter → skuAn importer brings a wine into the US.

distributesdistributor → skuA distributor carries a wine.

listed_byretailer|restaurant → skuA venue lists/pours a wine.

in_regionproducer|sku → regionLocated in / from a region.

has_grapesku → grapeMade from a grape variety.

subregion_ofregion → regionRegion hierarchy.

related_toreference → referenceCross-link between reference entries.

awardedaward → restaurant|retailer|sku|producerAn award held by an entity.

rated_bycritic|publication → sku|restaurantA rating from a critic/outlet.

reviewed_bypublication → restaurant|skuAn editorial review.

listed_inaward|publication → restaurant|retailerMembership in a curated list (Resy/OpenTable/50 Best).

The trust layer

Provenance envelope

Every enriched field carries provenance — value, source, confidence, and when it was observed — so merges are highest-confidence-wins and never silently overwrite. This is what makes the model trustworthy across many publishers.

value*objectThe asserted value.

source*stringSource identifier (connector / publisher).

confidence*number0–1 confidence.

observedAt*dateWhen observed (ISO date).

refstringSource URL / reference.

Cross-system

Identifiers

ttb_permit

US TTB importer/wholesaler permit number.

osm

OpenStreetMap `<type>/<id>`.

slug

WineGraph URL slug.

learned

A learned match key from the resolver corpus.

importer_site

Importer/distributor portfolio site-local id.

producer_name

Normalized producer name.

accolade_slug

Award/critic/publication slug.

Controlled

Vocabularies

Colours

red · white · rose · orange

Reference types

region · grape · place · term

Entity types (15)

producer · sku · vintage · brand · importer · distributor · retailer · restaurant · region · grape · place · term · award · critic · publication

Get involved

Adopt the standard

Read the data — the /v1 API + dataset speak this model.
Publish your data — expose a /.well-known/winegraph.json + a conformant feed; we (and anyone) can ingest it.
Build on it — type definitions, a connector SDK, a validator CLI, and a one-click site starter are on the way (open-source).

Spec licensed Apache-2.0 · open graph data ODbL · v0.1.0, semantically versioned.