{"version":"sources-2026.1","effectiveDate":"2026-09-21","note":"Every upstream this service uses, and — just as importantly — the ones it evaluated and rejected. A caller wondering why there are no AOC/DOCG blending rules should find the answer in the API, not have to guess from an absence.","policy":"CC0 or public domain only, and nothing that requires a key, an account or a registration. Wikidata's structured data is CC0; 27 CFR is a work of the United States Government. Neither needs a credential of any kind, and neither does this API.","used":[{"id":"wikidata","name":"Wikidata — structured data via the public SPARQL endpoint","url":"https://query.wikidata.org/","licence":"CC0 1.0 (public domain dedication)","licenceNote":"Wikidata's own licensing page: 'All structured data in the main, property and lexeme namespaces is made available under the Creative Commons CC0 License.' Only page TEXT is CC BY-SA, and none is used here.","key":"none","cadence":"edited continuously; polled weekly","provides":"2,782 grape varieties with berry colour (P11220), species (P171), country of origin (P495), parentage (P1531), VIVC cross-reference (P3904) and images (P18); plus 3,381 P186 co-occurrence claims.","limitation":"Crowd-sourced. Field coverage ranges from 69% (species) and 66% (colour) to 26% (parentage), 148 varieties carry self-contradictory colours, and demonstrable errors exist — see /v1/quality. WDQS also enforces a hard 60-second query timeout and has no SLA.","propertyNote":"Berry colour is P11220, NOT P462. P462 ('color') returns 2 of 2,782 and is the obvious-but-wrong choice; this cost a wrong measurement during research before it was caught.","classNote":"Varieties are selected with P31/P279* from Q958314 — an instance of 'grape variety' OR of any of its subclasses. Matching Q958314 directly, which this service did first, silently loses 330 varieties: Wikidata classes the American and French hybrids under Q1639967 ('hybrid grape') and its children Q766161 (Seibel), Q135913641 (Seyve-Villard) and Q7359245 (Rogers' Hybrids). Those are most of what US labelling law calls an American variety — Catawba, Chambourcin, Chancellor, Cayuga White, Seyval blanc, Aurore. Every record publishes the classes it instantiates and an isHybrid flag derived from them; whether a class counts as a hybrid is asked of Wikidata's subclass tree, not asserted here.","queryNote":"Three bounded queries, never an unbounded label search. Class membership is fetched separately from the variety fields: projecting the class into the main query pushed it past the 60s ceiling, and WDQS answered HTTP 200 with a TRUNCATED body rather than an error — a failure mode the fetcher now names explicitly instead of surfacing it as a JSON parse error."},{"id":"ecfr-title-27","name":"Electronic Code of Federal Regulations, Title 27 Part 4 — Labeling and Advertising of Wine","url":"https://www.ecfr.gov/current/title-27/part-4","licence":"public domain (work of the United States Government, 17 U.S.C. 105)","key":"none","cadence":"checked monthly","provides":"The US composition thresholds: the 75% varietal rule (4.23), the 85% appellation rule (4.25) and the vintage rules (4.27), quoted with citations.","limitation":"United States only. These govern what a wine sold in the US may be CALLED; they are not EU appellation blending rules.","fetchNote":"This endpoint answers HTTP 406 without compression — 'This endpoint requires response compression. Send an Accept-Encoding header that permits compression.' Node's fetch sends it by default; a hand-rolled curl needs --compressed."},{"id":"vivc-identifiers","name":"VIVC identifiers — referenced, never ingested","url":"https://www.vivc.de/","licence":"n/a — only the identifier is used, via Wikidata P3904","key":"none","cadence":"follows Wikidata","provides":"A stable cross-reference to the Vitis International Variety Catalogue for 1,276 varieties, so a caller can look up ampelographic detail at the authoritative source.","limitation":"NO VIVC content is stored or served. VIVC grants no reuse rights, so this service links out and stops there — the position already recorded across this fleet."}],"evaluatedAndRejected":[{"id":"eambrosia","name":"eAmbrosia — the EU geographical indications register","url":"https://ec.europa.eu/agriculture/eambrosia/geographical-indications-register/","wouldHaveProvided":"The actual product specifications behind AOC, DOCG and DO — including permitted grape varieties and blending percentages. This is the single most requested thing this service does not have.","reason":"Three independent blockers, any one of which is disqualifying. (1) Licence: data.europa.eu lists it under the 'European Commission reuse notice' (Decision 2011/833/EU), which carries a source-acknowledgement obligation and therefore fails this service's public-domain/CC0 bar. (2) Format: data.europa.eu lists exactly ONE distribution and its format is HTML; every candidate API path returns the Angular application shell rather than data. (3) Substance: the underlying specifications are per-appellation PDFs in 24 languages — legal prose, not a dataset.","note":"Checked 2026-09-21. This is settled, not a roadmap item."},{"id":"wikidata-blending-rules","name":"Blending rules from Wikidata itself","url":"https://www.wikidata.org/","wouldHaveProvided":"Permitted varieties and percentages per appellation.","reason":"No such property exists. Exactly ONE property in all of Wikidata mentions grapes — P3904, a VIVC cross-reference identifier — and there is none for composition, percentage or permitted varieties. Chianti Classico DOCG (Q2713152) carries no grape data at all. P186 records association, not permission, which is why this service labels it a co-occurrence claim."},{"id":"eur-lex","name":"EUR-Lex — EU wine regulations (1308/2013, 2019/33)","url":"https://eur-lex.europa.eu/","wouldHaveProvided":"The EU labelling and composition thresholds, as the counterpart to 27 CFR part 4.","reason":"Same European Commission reuse notice as eAmbrosia — a source-acknowledgement obligation rather than public domain."},{"id":"oiv","name":"International Organisation of Vine and Wine (OIV)","url":"https://www.oiv.int/","wouldHaveProvided":"Authoritative variety and synonym lists, and global plantings statistics.","reason":"Terms forbid 'any other use than those specified above, including commercial use'. A hard blocker, already recorded across this fleet."},{"id":"vivc-content","name":"VIVC ampelographic content (as opposed to its identifiers)","url":"https://www.vivc.de/","wouldHaveProvided":"The most complete grape-variety passport data that exists.","reason":"No reuse grant at all; written consent required, and as a German federal body there is no US-style automatic public-domain waiver. Repositories that scrape it licence their CODE, which does not licence VIVC's content. Identifiers only — see 'used'."},{"id":"dbpedia","name":"DBpedia","url":"https://www.dbpedia.org/","wouldHaveProvided":"Much the same entity coverage as Wikidata.","reason":"CC BY-SA 3.0 plus GFDL — share-alike reaches the whole combined work. Wikidata covers the same ground under CC0."}],"confidenceFormula":{"description":"Corroboration score, not a correctness claim. Each signal present adds its weight; the total is capped at 1.","signals":{"has a VIVC cross-reference (P3904)":0.35,"has a species/taxon (P171)":0.25,"has a country of origin (P495)":0.15,"colour normalised to the known vocabulary":0.15,"has recorded parentage (P1531)":0.1},"caution":"A high score means the entity is well described in Wikidata. It does not mean the values are correct — this service has found demonstrable errors in well-described records."},"plan":{"id":"free","name":"Free","limits":{"requestsPerMinute":60,"requestsPerDay":5000,"maxPageSize":100,"bulkDownloadsPerDay":50,"historyDays":30},"nextPlan":{"id":"free-key","name":"Free (with key)","available":true,"addsFeatures":[],"addsBudget":{"requestsPerMinute":300,"requestsPerDay":50000},"signupRequired":true,"reason":"You are hitting the anonymous per-IP limit.","url":"/grapes/v1/plans"},"publicInterest":{"summary":"Pro-level access is free for journalists, academics, nonprofits and public-interest researchers. Ask and it is granted.","contact":"https://www.linkedin.com/in/allanninal/"}},"datasetVersions":{"varieties":"wikidata-varieties-2026.1","relationships":"wikidata-p186-2026.1","compositionRules":"ecfr-title27-part4-2026.1"},"searchVersion":"search-2026.1","licence":"Every dataset served is CC0 or a work of the United States Government. See /grapes/license.html.","attribution":["Wikidata contributors (CC0 — no attribution required; given anyway)","Office of the Federal Register and the Government Publishing Office, eCFR"],"disclaimer":"Not an official source. Wikidata is crowd-sourced and contains errors, some of which are listed at /v1/quality. The US composition rules are citations to 27 CFR part 4, not legal advice — TTB determines what a label may say."}