Documentation
Log inGet started

Nutrition Facts Label OCR Node.js

Suggest Edits

The Node.js OCR SDK supports the Nutrition Facts Label API.

The sample below can be used for testing purposes.
Nutrition Facts Label sample

Quick-Start

const mindee = require("mindee");
// for TS or modules:
// import * as mindee from "mindee";

// Init a new client
const mindeeClient = new mindee.Client({ apiKey: "my-api-key" });

// Load a file from disk
const inputSource = mindeeClient.docFromPath("/path/to/the/file.ext");

// Parse the file
const apiResponse = mindeeClient.enqueueAndParse(
  mindee.product.NutritionFactsLabelV1,
  inputSource
);

// Handle the response Promise
apiResponse.then((resp) => {
  // print a string summary
  console.log(resp.document.toString());
});

Field Types

Standard Fields

These fields are generic and used in several products.

Basic Field

Each prediction object contains a set of fields that inherit from the generic Field class.
A typical Field object will have the following attributes:

  • value (number | string): corresponds to the field value. Can be undefined if no value was extracted.
  • confidence (number): the confidence score of the field prediction.
  • boundingBox ([Point, Point, Point, Point]): contains exactly 4 relative vertices (points) coordinates of a right rectangle containing the field in the document.
  • polygon (Point[]): contains the relative vertices coordinates (Point) of a polygon containing the field in the image.
  • pageId (number): the ID of the page, always undefined when at document-level.
  • reconstructed (boolean): indicates whether an object was reconstructed (not extracted as the API gave it).

Note: A Point simply refers to an array of two numbers ([number, number]).

Aside from the previous attributes, all basic fields have access to a toString() method that can be used to print their value as a string.

Amount Field

The amount field AmountField only has one constraint: its value is a number (or undefined).

Specific Fields

Fields which are specific to this product; they are not used in any other product.

Added Sugars Field

The amount of added sugars in the product.

A NutritionFactsLabelV1AddedSugar implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of added sugars to consume or not to exceed each day.
  • per100G (number): The amount of added sugars per 100g of the product.
  • perServing (number): The amount of added sugars per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Calories Field

The amount of calories in the product.

A NutritionFactsLabelV1Calorie implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of calories to consume or not to exceed each day.
  • per100G (number): The amount of calories per 100g of the product.
  • perServing (number): The amount of calories per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Cholesterol Field

The amount of cholesterol in the product.

A NutritionFactsLabelV1Cholesterol implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of cholesterol to consume or not to exceed each day.
  • per100G (number): The amount of cholesterol per 100g of the product.
  • perServing (number): The amount of cholesterol per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Dietary Fiber Field

The amount of dietary fiber in the product.

A NutritionFactsLabelV1DietaryFiber implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of dietary fiber to consume or not to exceed each day.
  • per100G (number): The amount of dietary fiber per 100g of the product.
  • perServing (number): The amount of dietary fiber per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

nutrients Field

The amount of nutrients in the product.

A NutritionFactsLabelV1Nutrient implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of nutrients to consume or not to exceed each day.
  • name (string): The name of nutrients of the product.
  • per100G (number): The amount of nutrients per 100g of the product.
  • perServing (number): The amount of nutrients per serving of the product.
  • unit (string): The unit of measurement for the amount of nutrients.
    Fields which are specific to this product; they are not used in any other product.

Protein Field

The amount of protein in the product.

A NutritionFactsLabelV1Protein implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of protein to consume or not to exceed each day.
  • per100G (number): The amount of protein per 100g of the product.
  • perServing (number): The amount of protein per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Saturated Fat Field

The amount of saturated fat in the product.

A NutritionFactsLabelV1SaturatedFat implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of saturated fat to consume or not to exceed each day.
  • per100G (number): The amount of saturated fat per 100g of the product.
  • perServing (number): The amount of saturated fat per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Serving Size Field

The size of a single serving of the product.

A NutritionFactsLabelV1ServingSize implements the following attributes:

  • amount (number): The amount of a single serving.
  • unit (string): The unit for the amount of a single serving.
    Fields which are specific to this product; they are not used in any other product.

sodium Field

The amount of sodium in the product.

A NutritionFactsLabelV1Sodium implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of sodium to consume or not to exceed each day.
  • per100G (number): The amount of sodium per 100g of the product.
  • perServing (number): The amount of sodium per serving of the product.
  • unit (string): The unit of measurement for the amount of sodium.
    Fields which are specific to this product; they are not used in any other product.

Total Carbohydrate Field

The total amount of carbohydrates in the product.

A NutritionFactsLabelV1TotalCarbohydrate implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of total carbohydrates to consume or not to exceed each day.
  • per100G (number): The amount of total carbohydrates per 100g of the product.
  • perServing (number): The amount of total carbohydrates per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Total Fat Field

The total amount of fat in the product.

A NutritionFactsLabelV1TotalFat implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of total fat to consume or not to exceed each day.
  • per100G (number): The amount of total fat per 100g of the product.
  • perServing (number): The amount of total fat per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Total Sugars Field

The total amount of sugars in the product.

A NutritionFactsLabelV1TotalSugar implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of total sugars to consume or not to exceed each day.
  • per100G (number): The amount of total sugars per 100g of the product.
  • perServing (number): The amount of total sugars per serving of the product.
    Fields which are specific to this product; they are not used in any other product.

Trans Fat Field

The amount of trans fat in the product.

A NutritionFactsLabelV1TransFat implements the following attributes:

  • dailyValue (number): DVs are the recommended amounts of trans fat to consume or not to exceed each day.
  • per100G (number): The amount of trans fat per 100g of the product.
  • perServing (number): The amount of trans fat per serving of the product.

Attributes

The following fields are extracted for Nutrition Facts Label V1:

Added Sugars

addedSugars (NutritionFactsLabelV1AddedSugar): The amount of added sugars in the product.

console.log(result.document.inference.prediction.addedSugars.value);

Calories

calories (NutritionFactsLabelV1Calorie): The amount of calories in the product.

console.log(result.document.inference.prediction.calories.value);

Cholesterol

cholesterol (NutritionFactsLabelV1Cholesterol): The amount of cholesterol in the product.

console.log(result.document.inference.prediction.cholesterol.value);

Dietary Fiber

dietaryFiber (NutritionFactsLabelV1DietaryFiber): The amount of dietary fiber in the product.

console.log(result.document.inference.prediction.dietaryFiber.value);

nutrients

nutrients (NutritionFactsLabelV1Nutrient[]): The amount of nutrients in the product.

for (const nutrientsElem of result.document.inference.prediction.nutrients) {
  console.log(nutrientsElem.value);
}

Protein

protein (NutritionFactsLabelV1Protein): The amount of protein in the product.

console.log(result.document.inference.prediction.protein.value);

Saturated Fat

saturatedFat (NutritionFactsLabelV1SaturatedFat): The amount of saturated fat in the product.

console.log(result.document.inference.prediction.saturatedFat.value);

Serving per Box

servingPerBox (AmountField): The number of servings in each box of the product.

console.log(result.document.inference.prediction.servingPerBox.value);

Serving Size

servingSize (NutritionFactsLabelV1ServingSize): The size of a single serving of the product.

console.log(result.document.inference.prediction.servingSize.value);

sodium

sodium (NutritionFactsLabelV1Sodium): The amount of sodium in the product.

console.log(result.document.inference.prediction.sodium.value);

Total Carbohydrate

totalCarbohydrate (NutritionFactsLabelV1TotalCarbohydrate): The total amount of carbohydrates in the product.

console.log(result.document.inference.prediction.totalCarbohydrate.value);

Total Fat

totalFat (NutritionFactsLabelV1TotalFat): The total amount of fat in the product.

console.log(result.document.inference.prediction.totalFat.value);

Total Sugars

totalSugars (NutritionFactsLabelV1TotalSugar): The total amount of sugars in the product.

console.log(result.document.inference.prediction.totalSugars.value);

Trans Fat

transFat (NutritionFactsLabelV1TransFat): The amount of trans fat in the product.

console.log(result.document.inference.prediction.transFat.value);

Questions?

Join our Slack

Updated 22 days ago