Canadian Nutrient File
HealthCAfood-nutrition.canada.ca
Health Canada's Canadian Nutrient File, the national reference food composition database: nutrient values per 100 g for about 5,700 foods commonly eaten in Canada, with household serving-size conversion factors, refuse and cooking yield factors, and the full nutrient dictionary behind them, in English and French.
Capabilities (15)
GET /v1/data/canadiannutrientfile/food1 creditReturns the single food record for one CNF food code: its code and full descriptive name.
GET /v1/data/canadiannutrientfile/foods1 creditReturns the entire CNF food index as a JSON array of {food_code, food_description} pairs - roughly 5,700 foods, which is the lookup table every other CNF capability is keyed on.
GET /v1/data/canadiannutrientfile/nutrient-amounts1 creditReturns every nutrient measured for one food per 100 g edible portion: nutrient_value, standard_error, number_observation, nutrient_name_id, nutrient_web_name and nutrient_source_id, typically 70-105 rows covering macros, minerals, vitamins, amino acids and individual fatty acids.
GET /v1/data/canadiannutrientfile/nutrient-group1 creditReturns one nutrient group heading: its id, name and display order.
GET /v1/data/canadiannutrientfile/nutrient-groups1 creditReturns the seven nutrient group headings that nutrients are filed under - Proximates, Other Carbohydrates, Minerals, Vitamins, Amino Acids, Lipids and Other components - each with its id and display order.
GET /v1/data/canadiannutrientfile/nutrient-name1 creditReturns one nutrient definition: its code, symbol, unit, full name, INFOODS tagname, rounding precision and group.
GET /v1/data/canadiannutrientfile/nutrient-names1 creditReturns the full CNF nutrient dictionary: nutrient_name_id, nutrient_code, symbol, unit of measure, full name, INFOODS tagname, decimal precision, web display name and order, and nutrient_group_id.
GET /v1/data/canadiannutrientfile/nutrient-source1 creditReturns one nutrient provenance record: its id, numeric code and description.
GET /v1/data/canadiannutrientfile/nutrient-sources1 creditReturns the provenance codes CNF attaches to every nutrient value - analysed in a Canadian government lab, imputed, taken from USDA, calculated, and so on - with id, code and description.
GET /v1/data/canadiannutrientfile/refuse-amounts1 creditReturns the inedible proportion of one food as a percentage, with the refuse description - bone, shell, peel, and so on.
GET /v1/data/canadiannutrientfile/refuse-amounts-bulk1 creditReturns the complete refuse table for every food in CNF - food code, description, percent refuse and refuse description.
GET /v1/data/canadiannutrientfile/serving-sizes1 creditReturns the household measures defined for one food, each with a conversion_factor_value - the multiplier applied to the per-100 g nutrient values to get the amount in that measure - plus the measure name and the food description.
GET /v1/data/canadiannutrientfile/serving-sizes-bulk1 creditReturns the complete serving size table for every food in CNF - food code, description, measure name and conversion factor - about 2.4 MB in one response.
GET /v1/data/canadiannutrientfile/yield-amounts1 creditReturns the yield factors recorded for one food - the weight change from refuse removal and cooking losses - with the yield description. Many foods have none and return an empty array.
GET /v1/data/canadiannutrientfile/yield-amounts-bulk1 creditReturns the complete yield table for the foods in CNF that have one - food code, description, yield amount and yield description.
Licence
The Canadian Nutrient File is published by Health Canada on open.canada.ca under the Open Government Licence - Canada (license_id "ca-ogl-lgo"), which states: "The Information Provider grants you a worldwide, royalty-free, perpetual, non-exclusive licence to use the Information, including for commercial purposes, subject to the terms below. You are free to: Copy, modify, publish, translate, adapt, distribute or otherwise use the Information in any medium, mode or format for any lawful purpose. You must, where you do any of the above: Acknowledge the source of the Information by including any attribution statement specified by the Information Provider(s) and, where possible, provide a link to this licence. If the Information Provider does not provide a specific attribution statement ... you must use the following attribution statement: Contains information licensed under the Open Government Licence - Canada." Exemptions: "This licence does not grant you any right to use: Personal Information; third party rights the Information Provider is not authorized to license; the names, crests, logos, or other official symbols of the Information Provider; and Information subject to other intellectual property rights, including patents, trade-marks and official marks." Non-endorsement: "This licence does not grant you any right to use the Information in a way that suggests any official status or that the Information Provider endorses you or your use of the Information." No warranty: "The Information is licensed 'as is', and the Information Provider excludes all representations, warranties, obligations, and liabilities, whether express or implied, to the maximum extent permitted by law." The API guide itself states the CNF API "allows developers to access that information in JSON and XML format for reuse in their own applications."
https://open.canada.ca/en/open-government-licence-canadaAttribution
Display this wherever you show the data. It arrives on every response as provenance.attribution_text.
Contains information licensed under the Open Government Licence - Canada. Source: Canadian Nutrient File, Health Canada
Cache: up to 3600s