https://openmenu.com/api/v2/ingredients.php?key=[API_KEY] + parameters

Parameters
key
[required] key for access to the API (get/view your key)
format: api key
offset
[not required] offset of results to get (paging)
format: integer with a max of 10 (default: 0)
s
[required] part or full string of an ingredient to search for
format: string
food_group
[not required] narrow results to a single food group
format: select from: Dairy and Egg Products | Spices and Herbs | Baby Foods | Fats and Oils | Poultry Products | Soups, Sauces, and Gravies | Sausages and Luncheon Meats | Breakfast Cereals | Fruits and Fruit Juices | Pork Products | Vegetables and Vegetable Products | Nut and Seed Products | Beef Products | Beverages | Finfish and Shellfish Products | Legumes and Legume Products | Lamb, Veal, and Game Products | Baked Products | Sweets | Cereal Grains and Pasta | Fast Foods | Meals, Entrees, and Side Dishes | Snacks | American Indian/Alaska Native Foods | Restaurant Foods
nutrition
[not required] include nutritional information in the results
format: 0 | 1
Return Values
api
Returns details about the API and call
  • status: see below Return Status Codes
  • api_version: 2.1
  • format: json
  • api_key: [your api key]
ingredients
Return of ingredients with the following structure
  • ingredient_id: generated key
  • description: string
  • manufacturer_name: string
  • food_group: Dairy and Egg Products | Spices and Herbs | Baby Foods | Fats and Oils | Poultry Products | Soups, Sauces, and Gravies | Sausages and Luncheon Meats | Breakfast Cereals | Fruits and Fruit Juices | Pork Products | Vegetables and Vegetable Products | Nut and Seed Products | Beef Products | Beverages | Finfish and Shellfish Products | Legumes and Legume Products | Lamb, Veal, and Game Products | Baked Products | Sweets | Cereal Grains and Pasta | Fast Foods | Meals, Entrees, and Side Dishes | Snacks | American Indian/Alaska Native Foods | Restaurant Foods
  • refuse_percentage: float
  • refuse_description: string
  • weight_in_grams: float
  • measurements:
    • description: string
    • weight_amount: float
    • weight_grams: float
    • edible_portion: float
  • claims:
    • alcohol_free: true | false
    • sodium_free: true | false
    • good_source_protein: true | false
    • high_protein: true | false
    • good_source_fiber: true | false
    • high_fiber: true | false
  • calories:
    • calories_alcohol: float
    • calories_fat: float
    • calories_carbohydrates: float
    • calories_protein: float
    • total: float
  • nutrition:
    [total_fat | saturated_fat | trans_fat | cholesterol | sodium | total_carbohydrate | dietary_fiber | total_sugars | protein | vitamin_a | vitamin_c | vitamin_b6 | vitamin_d | vitamin_e | iron | calcium | magnesium]
    • amount: float
    • units: string
    • daily_value: percentage
Return Status Codes
200
successful call
204
call resulted in an empty resultset
400
incorrect or missing API key
404
incorrect or missing required parameter
429
call limit exceeded on API key (check your limit)
Sample Response
Notes