{"version":"chem-sources-2026.1","effectiveDate":"2026-09-17","note":"Every upstream this service uses, and everything it evaluated and rejected, with the reason. The rejections matter more here than in any sibling: this service was briefed as a wine QUALITY PREDICTION API, and the dataset that task requires could not be used. Rather than quietly ship something different, the gap is stated here and on the landing page.","policy":"Public domain only, and nothing that requires a key, an account, a registration or a request of any kind. 27 CFR is a work of the United States Government under 17 U.S.C. §105. This API asks nothing of its callers either.","used":[{"id":"ecfr-title27-part4","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":"US federal government work — public domain (17 U.S.C. §105)","licenceNote":"A work of the United States Government is not subject to copyright protection in the United States. No attribution obligation attaches; attribution is given anyway.","key":"none","cadence":"Revised on rulemaking; the current issue date is recorded with every build and served at /v1/version.","provides":"The federal composition maxima: volatile acidity by wine class and colour (§4.21), the 350 ppm total sulfur dioxide ceiling (§4.22), and the 10 ppm threshold that forces a sulfite declaration (§4.32).","limitation":"Limits live in prose, not in fields. One sentence in §4.21 carries four different maxima with four different conditions. This service curates the rule STRUCTURE by hand and verifies every NUMBER against the source text, refusing to publish a limit the source does not state.","scopeNote":"§§4.23, 4.25 and 4.27 — the varietal, appellation and vintage LABELLING thresholds — are deliberately NOT served here. They belong to the grape variety API at /grapes and duplicating them would create two places to be wrong.","fetchNote":"The eCFR versioner endpoint answers HTTP 406 without compression. Node's fetch sends accept-encoding by default; a hand-rolled curl needs --compressed.","archiveNote":"eCFR serves a POINT-IN-TIME archive: /api/versioner/v1/full/<date>/title-27.xml answers for dates years back (verified against 2020-06-15). This service's own history is therefore a convenience — the parsed and diffed form — and not an irreplaceable record. It is stated here because the opposite claim would oversell it."},{"id":"ecfr-title27-part24","name":"Electronic Code of Federal Regulations — Title 27 Part 24, Wine","url":"https://www.ecfr.gov/current/title-27/part-24","licence":"US federal government work — public domain (17 U.S.C. §105)","licenceNote":"Same basis as part 4.","key":"none","cadence":"Revised on rulemaking.","provides":"§24.246 Table 1 — every material authorised for treating wine or juice, with the specific TTB limitation where one applies and the FDA reference — plus the amelioration, sweetening and cellar-treatment sections (§§24.176-24.192, 24.248).","limitation":"The §24.246 table has FIVE row shapes, and a naive parser silently misattributes limits between substances. A material heading occupies a row of its own; uses beneath it inherit it; a row with an EMPTY first cell continues the previous row's limitation text; and some rows have no FDA column at all. Reading only three-cell rows drops the headings and the two-cell rows, which leaves the current-material pointer stale and attaches an enzyme's limit to dimethyl dicarbonate. Every one of those was found by a validation gate failing, not by reading a spec.","tableNote":"One published record per material-and-use, not per material: the TTB limit differs by use, so collapsing them would force a single limit onto uses that have different ones.","archiveNote":"eCFR serves a POINT-IN-TIME archive: /api/versioner/v1/full/<date>/title-27.xml answers for dates years back (verified against 2020-06-15). This service's own history is therefore a convenience — the parsed and diffed form — and not an irreplaceable record. It is stated here because the opposite claim would oversell it."}],"evaluatedAndRejected":[{"id":"uci-wine-quality","name":"UCI Machine Learning Repository — Wine Quality (Cortez, Cerdeira, Almeida, Matos and Reis, 2009)","url":"https://archive.ics.uci.edu/dataset/186/wine+quality","wouldHaveProvided":"The entire quality-prediction half of this service as it was originally briefed: 6,497 red and white Vinho Verde samples pairing eleven physicochemical measurements with a sensory quality score from a panel of wine experts. It is the canonical dataset for predicting wine quality from chemistry, and with it this API would have served a trained model.","reason":"Licence. UCI publishes it under Creative Commons Attribution 4.0 (CC BY 4.0), which carries an attribution obligation. This fleet's rule is public domain or CC0 only — the same rule that excluded FAOSTAT for being CC BY. Access was never the problem: the download needs no key, no account and no registration. The licence alone disqualifies it.","whatWasConsidered":"Mirrors on Kaggle and GitHub were checked and rejected for the same reason plus a worse one: they are re-uploads of the same Cortez data, and a repository's licence badge cannot manufacture rights the uploader never held. The original distribution by the authors carries no explicit licence at all, which under default copyright is more restrictive, not less.","consequence":"There is NO model in this service and no prediction endpoint. What replaced it is the federal compliance and cellar-chemistry layer documented above, which serves the same audience — winery QC labs — from sources that are public domain."},{"id":"usda-fooddata-central","name":"USDA FoodData Central","url":"https://fdc.nal.usda.gov/","wouldHaveProvided":"A public-domain substitute training set: US federal, no licence obstacle, and it does carry wine composition.","reason":"It has no sensory quality scores. Composition without a quality target is not a training set for quality prediction, so it could not replace the rejected dataset even though its licence is acceptable. It is recorded here because 'find a public-domain alternative' is the obvious first suggestion and this is where that search ends."},{"id":"oiv","name":"OIV — International Organisation of Vine and Wine, compendium of analysis methods and maximum acceptable limits","url":"https://www.oiv.int/","wouldHaveProvided":"International analytical limits, which would have extended this service beyond US federal law.","reason":"OIV's terms forbid uses other than those specified, including commercial use. Already in this fleet's rejection register from an earlier build; not re-litigated."},{"id":"aoac","name":"AOAC INTERNATIONAL Official Methods of Analysis","url":"https://www.aoac.org/","wouldHaveProvided":"The reference laboratory methods behind the numbers a QC lab measures.","reason":"Copyrighted and sold. Not public domain. This service reports limits, never methods, and does not tell you how to run an assay."},{"id":"state-alcohol-regulators","name":"State alcoholic beverage control regulations","wouldHaveProvided":"State composition limits, which can be stricter than federal ones.","reason":"Not a single obtainable dataset — fifty separate bodies of law in fifty formats, many not machine-readable. Out of scope rather than rejected on licence, and declared so that nobody reads a federal pass as a national one."}],"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":"/chem/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":{"compositionLimits":"ecfr-title27-part4-2026.1","treatmentMaterials":"ecfr-title27-part24-246-2026.1","productionLimits":"ecfr-title27-part24-2026.1"},"cfrIssueDate":"2026-09-17","searchVersion":"chem-search-1","licence":"Every dataset served is a work of the United States Government and is public domain. See /chem/license.html.","attribution":["Office of the Federal Register and the Government Publishing Office, Electronic Code of Federal Regulations","Alcohol and Tobacco Tax and Trade Bureau, 27 CFR parts 4 and 24"],"notLegalAdvice":"This reports what the Code of Federal Regulations says. It is not legal advice, not a TTB determination, and federal only — a state may be stricter."}