Get raw/generic food ingredient item(s)

v1.0.0

Get data for a specific ingredient or a specific set of ingredients.

Example #1: Single Ingredient

https://chompthis.com/api/v2/ingredient/search.php?api_key=API_KEY&find=raw broccoli

Example #2: Set of Ingredients

https://chompthis.com/api/v2/ingredient/search.php?api_key=API_KEY&find=raw broccoli,mashed potatoes,chicken drumstick

Tips

Expose ingredient endpoints by using our .

This API endpoint is only available to Standard and Premium API subscribers. Please consider upgrading your subscription if you are subscribed to the Limited plan. if you aren't sure how to upgrade your subscription.

Input

{
  "type": "object",
  "properties": {
    "find": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "enum": [
        1,
        2,
        3
      ]
    }
  },
  "required": [
    "find"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Please read the description of each field in this API response object example. By default, the value of each field is **null**. This indicates an unknown state or that no data exists.",
  "properties": {
    "items": {
      "type": "array",
      "description": "An array containing an object for each individual item returned by your API call.",
      "items": {
        "type": "object",
        "description": "An object containing information for this specific item.",
        "properties": {
          "calorie_conversion_factor": {
            "type": "object",
            "description": "An object containing the multiplication factors to be used when calculating energy from macronutrients for a specific food.",
            "properties": {
              "carbohydrate_value": {
                "type": "number",
                "description": "The multiplication factor for carbohydrates"
              },
              "fat_value": {
                "type": "number",
                "description": "The multiplication factor for fat"
              },
              "protein_value": {
                "type": "number",
                "description": "The multiplication factor for protein"
              }
            }
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "An array of categories for this item"
            }
          },
          "common_name": {
            "type": "string",
            "description": "Common name associated with this item. These generally clarify what the item is (e.g. when the brand name is \"BRAND's Spicy Enchilada\" the common name may be \"Chicken enchilada\")"
          },
          "components": {
            "type": "array",
            "description": "An array of objects containing the constituent parts of a food (e.g. bone is a component of meat)",
            "items": {
              "type": "object",
              "description": "An object containing information on a specific component of this food item",
              "properties": {
                "data_points": {
                  "type": "integer",
                  "description": "The number of obersvations on which the measure is based"
                },
                "gram_weight": {
                  "type": "number",
                  "description": "The weight of the component in grams"
                },
                "is_refuse": {
                  "type": "boolean",
                  "description": "Whether the component is refuse, i.e. not edible"
                },
                "name": {
                  "type": "string",
                  "description": "The kind of component, e.g. bone"
                },
                "pct_weight": {
                  "type": "number",
                  "description": "The weight of the component as a percentage of the total weight of the food"
                }
              }
            }
          },
          "footnote": {
            "type": "string",
            "description": "Comments on any unusual aspects of this item. Examples might include unusual aspects of the food overall"
          },
          "name": {
            "type": "string",
            "description": "Item name as provided by brand owner or as shown on packaging"
          },
          "nutrients": {
            "type": "array",
            "description": "An array containing nutrient informatio objects for this food item",
            "items": {
              "type": "object",
              "description": "An object containing information for a specific nutrient found in this food item",
              "properties": {
                "data_points": {
                  "type": "integer",
                  "description": "Number of observations on which the value is based"
                },
                "description": {
                  "type": "string",
                  "description": "Description of the nutrient source"
                },
                "footnote": {
                  "type": "string",
                  "description": "Comments on any unusual aspect of the food nutrient. Examples might include why a nutrient value is different than typically expected."
                },
                "max": {
                  "type": "number",
                  "description": "Maximum nutrient value"
                },
                "measurement_unit": {
                  "type": "string",
                  "description": "The unit used for the measure of this nutrient"
                },
                "median": {
                  "type": "number",
                  "description": "Median nutrient value"
                },
                "min": {
                  "type": "number",
                  "description": "Minimum nutrient value"
                },
                "name": {
                  "type": "string",
                  "description": "Nutrient name"
                },
                "per_100g": {
                  "type": "number",
                  "description": "Amount of the nutrient per 100g of food"
                },
                "rank": {
                  "type": "integer",
                  "description": "Nutrient rank"
                }
              }
            }
          },
          "portions": {
            "type": "array",
            "description": "An array of objects containing information on discrete amounts of a food found in this item",
            "items": {
              "type": "object",
              "description": "An object containing information on a specific food portion found in this item",
              "properties": {
                "data_points": {
                  "type": "integer",
                  "description": "The number of observations on which the measure is based"
                },
                "description": {
                  "type": "string",
                  "description": "Comments that provide more specificity on the measure. For example, for a pizza measure the dissemination text might be 1 slice is 1/8th of a 14 inch pizza."
                },
                "footnote": {
                  "type": "string",
                  "description": "Comments on any unusual aspects of the measure. Examples might includes caveats on the usage of a measure, or reasons why a measure gram weight is an unexpected value."
                },
                "gram_weight": {
                  "type": "number",
                  "description": "The weight of the measure in grams"
                },
                "measurement_unit": {
                  "type": "string",
                  "description": "The unit used for measure (e.g. if mesure is 3 tsp, the unit is tsp)"
                },
                "modifier": {
                  "type": "string",
                  "description": "Qualifier of the measure (e.g. related to food shape or form) (e.g. melted, crushed, diced)"
                }
              }
            }
          },
          "protein_conversion_factor": {
            "type": "number",
            "description": "The multiplication factor used to calculate protein from nitrogen"
          },
          "score": {
            "type": "string",
            "description": "A value that represents how similar the name of this food item is to the original search term. The lower the value the closer this item's name is to the original search term."
          },
          "search_term": {
            "type": "string",
            "description": "The original search term that found this food item"
          }
        }
      }
    }
  }
}