Ingredient density API

Try it now

This works as written, with nothing to sign up for first:

curl -s https://cupsngrams.com/api/v1/ingredients | head -40

Or from a browser, since CORS is open:

const res = await fetch("https://cupsngrams.com/api/v1/ingredients");
const { ingredients } = await res.json();

const flour = ingredients.find(i => i.slug === "all-purpose-flour");
console.log(flour.gramsPerUsCup); // 125

Endpoints

The ingredient record

{
  "slug": "all-purpose-flour",
  "name": "All-Purpose Flour",
  "category": "Flours & starches",
  "gramsPerUsCup": 125,
  "gramsPerTablespoon": 7.813,
  "gramsPerTeaspoon": 2.604,
  "gramsPerMillilitre": 0.52083,
  "ouncesPerUsCup": 4.41,
  "url": "https://cupsngrams.com/all-purpose-flour",
  "lastVerified": "2026-08-05",
  "unverified": false,
  "sources": [
    {
      "label": "King Arthur Baking ingredient weight chart",
      "url": "https://www.kingarthurbaking.com/learn/ingredient-weight-chart",
      "publishes": 120,
      "note": "Spooned into the cup and levelled off, never scooped."
    }
  ]
}

Two fields deserve a word. publishes is the figure that source prints, which is deliberately not always our gramsPerUsCup: where references disagree we show both instead of quietly picking one. And unverified: true means exactly what it says, that we have not yet found a published reference for that figure. It is not a quality score, it is an honest gap, and you may want to surface it differently in your own product.

Units and conventions

• All cup figures are per US legal cup, 240 ml. Use gramsPerMillilitre with a different cup volume if you need another standard.
• ouncesPerUsCup is ounces of weight, never fluid ounces.
• Values are rounded to three decimal places, which is far beyond any kitchen’s ability to measure and is there so your own arithmetic does not accumulate error.
• lastVerified is per record, not per file. Different ingredients were checked on different days and the data says so.

Licence and attribution

Published under Creative Commons Attribution 4.0. Commercial use is fine, modification is fine, redistribution is fine. The condition is a visible credit link wherever the figures appear, for example:

Ingredient weights from <a href="https://cupsngrams.com">CupsToGrams</a> (CC BY 4.0)

That link is the entire business model of this dataset. The site is free, carries no advertising and sells nothing; publishing the data openly and being credited for it is what makes the work worth doing. If crediting is genuinely impossible in your context, get in touch and we will sort something out.

Versioning

The /v1/ path is a promise: fields will be added but never renamed or removed within v1, so an integration written today keeps working. Anything breaking becomes /v2/ and v1 stays up. Data changes are listed on the changelog, and every response carries a lastModified field if you would rather poll than read.

Caching and fair use

Responses are static files behind a CDN with Cache-Control: public, max-age=3600. There is no rate limit and you will not be blocked, but if you are calling this on every page load of a busy site, copy the JSON into your own build instead. It changes a handful of times a year and your users will thank you for the latency.

Frequently asked questions

Data last updated 5 August 2026. Method on the methodology page.