Open measurement data · 2026-10-17
The labels, the calculations, the sources
Download 716 magnesium label records from the NIH DSLD snapshot dated 2026-08-10, enriched with explicit salt-mass intervals, capsule verdicts and dated price evidence calculated 2026-10-17.
Page-level files
Every data page carries its own CSV
Pages on the current template publish the values they display as a CSV with one row per value, a claim identifier and the data release; a versioned copy ({name}-{release}.csv) never changes, and the address without a release always points to the latest.
| Page family | Address pattern | Files | Example |
|---|---|---|---|
| Salt pages | /data/salts/{salt}.csv | 19 | /data/salts/amino-acid-chelate.csv |
| Price rankings within a salt | /data/rankings/{salt}.csv | 5 | /data/rankings/citrate.csv |
| Product labels (template B) | /data/labels/{dsld_id}.csv | 716 | /data/labels/258459.csv |
| Salt pairs | /data/pairs/{a}-vs-{b}.csv | 45 | /data/pairs/aspartate-vs-carbonate.csv |
| Brands | /data/brands/{brand}.csv | 136 | /data/brands/absolute-nutrition.csv |
| Facets and formulations | /data/facets/{kind}-{slug}.csv | 136 | /data/facets/excipients-citric-acid.csv |
Downloads
Six files, with their row counts and dates
The release dated 2026-10-17 provides 6 downloadable files; counts below exclude the CSV header and count records in JSON arrays.
| File | Rows | Snapshot / observation basis | Licence |
|---|---|---|---|
| elementaldose-labels.csv One row per retained NIH DSLD label, with declared magnesium, compound-mass intervals, capsule verdicts, enrichment and confirmed-price fields. | 716 | Registry snapshot 2026-08-10; calculations 2026-10-17 | CC BY 4.0 on our derivatives; public-domain DSLD source data |
| elementaldose-labels.json The same records and fields as the label CSV, retaining numeric and boolean types and dated missing-data statements. | 716 | Registry snapshot 2026-08-10; calculations 2026-10-17 | CC BY 4.0 on our derivatives; public-domain DSLD source data |
| elementaldose-label-audit.csv The exact subset of the label dataset whose fill_verdict is exceeds-all or needs-000, with the complete label export schema. | 55 | Registry snapshot 2026-08-10; calculations 2026-10-17 | CC BY 4.0 on our derivatives; public-domain DSLD source data |
| elementaldose-studies.csv PMID, year, journal, title, salts, design and limits for every study in the retained literature set. | 16 | PubMed bibliography verified 2026-09-11 | CC BY 4.0 on our derivatives; public-domain DSLD source data |
| elementaldose-gold-set.csv The compact price dataset, restricted to explicit confirmed matches and retaining its original column names. | 75 | Registry snapshot 2026-08-10; each row retains its price observation date | CC BY 4.0 on our derivatives; public-domain DSLD source data |
| elementaldose-gold-set.json The same confirmed price observations and EC100 arithmetic as the compact gold-set CSV. | 75 | Registry snapshot 2026-08-10; each row retains its price observation date | CC BY 4.0 on our derivatives; public-domain DSLD source data |
Schema and reuse
A row you can trace back to its label
Each of the 716 label rows has 28 fields in this 2026-10-17 release, including dsld_id, both compound-mass endpoints and the original observation dates.
| Field group | Contract |
|---|---|
| Identity and dates | dsld_id, brand, name, physical_state, label_date, snapshot_date and derived_date. Join by the integer label ID; retain the dates. |
| Salt and amount | salt, salt_source, elemental_mg_serving, servings, elemental_mg_container, compound_mg_serving_low/high and compound_mg_per_unit. All mass fields use mg. |
| Intervals | Compound mass per serving has separate numeric endpoints. Per-unit mass uses a low–high string when hydration is ambiguous; a single value applies only where both endpoints coincide. |
| Capsule model | fill_verdict and required_capsule_size preserve the favourable-bound model. The audit file filters exactly exceeds-all and needs-000. |
| Enrichment | has_stearate, capsule_material, target_groups, upc and version_count. Target groups are joined with |; preserve the barcode as text to retain leading zeros. |
| Price evidence | price_usd, ec100_usd, match_confidence and price_observed_at. Only explicit confirmed matches populate the price fields; historical flags remain explicit. |
| Missing data | Unavailable values carry a reason and “as of 2026-10-17”. They are not zeros or blank cells. JSON keeps available quantities numeric and has_stearate boolean. |
| Study records | pmid, year, journal, title, salts, design and limits. Salts use | as the delimiter; each PMID resolves to its PubMed record. |
| CSV encoding | UTF-8, comma-delimited, quoted text where needed, one physical line per record plus the header. Embedded line breaks are normalized to spaces. |
The label CSV and JSON contain the same records in the same order. The audit is a subset with the same columns, so an audit row can be joined directly to the full download. A benchmark on an unpriced product page does not enter the observed-price fields. Read the complete field dictionary and inspect the corpus audit.
Source and licence
Credit the source and the derivative work
The 6 files in the 2026-10-17 release apply CC BY 4.0 to ElementalDose’s derivative work, except the dated retail price observations; the underlying DSLD data are public domain, with source acknowledgement requested by the NIH API guide.
| Material | Credit and terms |
|---|---|
| Our calculations, selection and explanatory text | Creative Commons Attribution 4.0. Credit ElementalDose, link to this release and licence, and indicate changes. |
| Retail price observations | The fields price_usd, ec100_usd, match_confidence and price_observed_at, and the confirmed-match files, are dated observations of third-party retail listings obtained through a licensed data provider. They are shown for reference and are not licensed under CC BY 4.0 for redistribution; the Zenodo archive excludes them. |
| Registry source data | NIH Office of Dietary Supplements, Dietary Supplement Label Database (DSLD), snapshot 2026-08-10. DSLD API guide and reuse statement. |
| Study metadata and our summaries | Cite the PMID and original authors for the study; credit ElementalDose for the assembled derivative dataset. The download does not license the full papers. |
| Suggested attribution | Ivitskiy, I. (2026). ElementalDose: label arithmetic for US magnesium supplement labels (Version 2026-10-19) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.23479007 Source: NIH ODS Dietary Supplement Label Database, snapshot 2026-08-10; CC BY 4.0 for ElementalDose derivatives. |
These URLs serve the current static release and change with each weekly refresh. The label table, capsule audit and study registry are archived without retail prices at Zenodo, doi:10.5281/zenodo.23479007, CC BY 4.0; cite that DOI for a fixed version, or doi:10.5281/zenodo.22951468 for all versions.