{
  "name": "Grape Variety & Appellation Reference API — static tier",
  "free": true,
  "note": "Every file here is free, cacheable and needs no key. Wikidata's structured data is CC0 and 27 CFR is a US federal work; you may redistribute both commercially without asking.",
  "datasets": {
    "varieties": "/grapes/api/v1/varieties.json",
    "varietiesIndex": "/grapes/api/v1/varieties-index.json",
    "varietiesWellAttested": "/grapes/api/v1/varieties-wellattested.json",
    "relationships": "/grapes/api/v1/relationships.json",
    "compositionRules": "/grapes/api/v1/composition-rules.json",
    "qualityReport": "/grapes/api/v1/quality-report.json"
  },
  "service": {
    "meta": "/grapes/api/v1/meta.json",
    "plans": "/grapes/api/v1/plans.json",
    "versions": "/grapes/api/v1/versions.json",
    "sources": "/grapes/api/v1/sources.json",
    "openapi": "/grapes/openapi.yaml"
  },
  "counts": {
    "varieties": 2782,
    "varietiesWithColour": 1826,
    "varietiesWithVivc": 1608,
    "relationships": 3381,
    "compositionRuleSections": 3,
    "knownBadClaims": 2
  },
  "licensing": {
    "policy": "Every dataset served is CC0 or a work of the United States Government. No share-alike, no non-commercial, and no attribution obligation anywhere in the critical path.",
    "document": "LICENSE-DATA.md",
    "wikidataNote": "Wikidata structured data in the main, property and lexeme namespaces is CC0. Only page text is CC BY-SA, and none is used here.",
    "vivcNote": "VIVC identifiers are REFERENCED via Wikidata P3904. No VIVC content is ingested — VIVC grants no reuse rights."
  },
  "notCovered": [
    "EU appellation blending rules (AOC, DOCG, DO). These are not published as data anywhere obtainable. Wikidata has no property for grape composition or percentage. eAmbrosia, the EU's official GI register, offers exactly one distribution on data.europa.eu and its format is HTML; its terms are the European Commission reuse notice, which carries a source-acknowledgement obligation and fails this fleet's public-domain bar; and the underlying specifications are per-appellation PDFs in 24 languages. Declared at /v1/sources rather than hidden.",
    "Global appellation coverage. Wikidata's appellation classing is inconsistent — 31 entities are typed as AOC and 2 as DOCG — so there is no coherent global class to build on.",
    "US AVAs and TTB-approved variety names. Those are served by the US Wine Reference API at /wine; this service cross-references them by Wikidata QID rather than re-deriving them.",
    "Boundary geometry."
  ],
  "readThisFirst": "relationships.json holds CO-OCCURRENCE CLAIMS, not permitted-variety lists and not blending rules. Every record says so. See quality-report.json for claims known to be wrong."
}