Food Ingredient Information API

What it does

The ingredient API gives food apps one place to search ingredients, pull their nutrition, and find alternatives. Search by name with query, or use the autocomplete endpoint for type-ahead fields, then fetch full details by id. Ingredient Information returns calories, macros, glycemic index and a caloric breakdown for any amount and unit, plus aisle, estimated cost and possible units.

Eight endpoints cover the rest of the flow. Get Ingredient Substitutes returns alternatives by name or id, such as margarine or ghee for butter. Compute Ingredient Amount works backward from a nutrient target, for example how much of an ingredient gives 10 g of protein. Map Ingredients to Grocery Products turns a recipe's ingredient list and servings into matching products with UPC codes. The ingredient widget endpoint renders a recipe's ingredient list as a PNG in US or metric units. Search can filter by intolerances and by fat, carb and protein percentage, in English or German.

Use the ingredient API in meal planners and diet trackers that need nutrition per portion, recipe apps that suggest ingredient substitution for allergies or missing items, and grocery and delivery apps that turn a recipe into a shopping cart.

Parse free-text recipes into structured ingredients first with the Ingredient Parser API. For recipe discovery, use the Food Search API, and suggest a bottle for the finished dish with the Wine Pairing API.

▣ ENDPOINT 01 / 08

GET

Ingredient Search

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/search

QUICKSTART

GUIDE

Quickstart

Search for ingredients by a keyword query and return the first page of matching results.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/search?query=burger" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with results, offset, number, and totalResults fields. results is an array of ingredient objects, each with id, name, and image; offset and number describe the page, and totalResults is the total number of matches.

{
  "number": 10,
  "offset": 0,
  "results": [
    {
      "id": 123,
      "name": "Burger",
      "image": "burger.png"
    }
  ],
  "totalResults": 1
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for food ingredients by a query string and returns a paginated JSON object containing the matching results plus paging metadata.

Query Parameter(s)

Attribute	Type	Description
sort	String	Sort field to use for the search results.
query	String	Search term to look up ingredients.
number	Integer	Number of results to return. Default: `10`. Minimum: `1`, maximum: `100`.
offset	Integer	Zero-based offset into the result set. Minimum: `0`, maximum: `900`.
language	ENUM	Response language. Allowed values: `en`, `de`.
addChildren	Boolean	Whether to include child ingredients.
intolerances	String	Intolerance filter to apply.
maxFatPercent	Number	Maximum fat percentage filter.
minFatPercent	Number	Minimum fat percentage filter.
sortDirection	String	Sort direction.
maxCarbsPercent	Number	Maximum carbohydrate percentage filter.
metaInformation	Boolean	Whether to include meta information.
minCarbsPercent	Number	Minimum carbohydrate percentage filter.
maxProteinPercent	Number	Maximum protein percentage filter.
minProteinPercent	Number	Minimum protein percentage filter.

Response

Returns a JSON object with number and offset integer fields, a results array field, and a totalResults integer field. The results array contains objects with id integer, name string, and image string fields.

Parameter	Type	Description
number	Integer	Number of results returned in this page.
offset	Integer	Offset used for this page.
results	Object Array	Array of ingredient result objects. Each item includes: - `id` integer - `name` string - `image` string
totalResults	Integer	Total number of matching results.

▣ ENDPOINT 02 / 08

GET

Get Ingredient Information

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/information

QUICKSTART

GUIDE

Quickstart

Fetch ingredient information for a specific ingredient ID, with optional unit and amount query parameters.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/information?unit=grams&amount=150" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with fields such as id, name, original, originalName, amount, unit, unitShort, unitLong, possibleUnits, estimatedCost, consistency, aisle, image, and meta. It may also include a nested nutrition object with nutrients, properties, caloricBreakdown, and weightPerServing.

{
  "id": 12135,
  "original": "nuts",
  "originalName": "nuts",
  "name": "nuts",
  "amount": 150,
  "unit": "grams",
  "unitShort": "g",
  "unitLong": "grams",
  "possibleUnits": ["handful", "g", "ounce", "oz", "cup", "serving", "tablespoon"],
  "estimatedCost": {
    "value": 182.14,
    "unit": "cents"
  },
  "consistency": "solid",
  "shoppingListUnits": ["ounces", "pounds"],
  "aisle": "Nuts",
  "image": "nuts-mixed.jpg",
  "meta": [],
  "nutrition": {
    "nutrients": [
      {"name": "Calories", "amount": 891, "unit": "kcal", "percentOfDailyNeeds": 44.55},
      {"name": "Protein", "amount": 25.95, "unit": "g", "percentOfDailyNeeds": 51.9},
      {"name": "Carbohydrates", "amount": 38.03, "unit": "g", "percentOfDailyNeeds": 12.68},
      {"name": "Fat", "amount": 77.18, "unit": "g", "percentOfDailyNeeds": 118.73},
      {"name": "Fiber", "amount": 13.5, "unit": "g", "percentOfDailyNeeds": 54}
    ],
    "properties": [
      {"name": "Glycemic Index", "amount": 29.67, "unit": ""},
      {"name": "Glycemic Load", "amount": 7.28, "unit": ""},
      {"name": "Nutrition Score", "amount": 27.72, "unit": "%"}
    ],
    "flavonoids": [],
    "caloricBreakdown": {
      "percentProtein": 10.92,
      "percentFat": 73.08,
      "percentCarbs": 16
    },
    "weightPerServing": {
      "amount": 150,
      "unit": "g"
    }
  },
  "categoryPath": ["snack"]
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves information for a specific ingredient by its id. You can optionally supply unit and amount query parameters to request the ingredient information in a particular quantity and unit.

Path Parameter(s)

Attribute	Type	Description
id	Integer	The ingredient identifier in the path.

Query Parameter(s)

Attribute	Type	Description
unit	String	The unit to use for the ingredient quantity.
amount	Number	The amount to use with `unit`.

Response

Returns a JSON object with ingredient details, including top-level fields

Parameter	Type	Description
id	Integer	Ingredient identifier.
meta	String Array	Metadata values associated with the ingredient.
name	String	Ingredient name.
unit	String	Unit used in the response.
aisle	String	Aisle name for the ingredient.
image	String	Image filename for the ingredient.
amount	Number	Amount represented by the response.
original	String	Original ingredient text.
unitLong	String	Long-form unit name.
nutrition	Object	Nutrition details object. Contains `nutrients`, `properties`, `caloricBreakdown`, and `weightPerServing`; see schema for nested fields.
unitShort	String	Short-form unit name.
consistency	String	Ingredient consistency.
categoryPath	String Array	Category path values for the ingredient.
originalName	String	Original ingredient name.
estimatedCost	Object	Estimated cost object with `value` and `unit`.
possibleUnits	String Array	Units supported for this ingredient.
shoppingListUnits	String Array	Units suitable for shopping lists.

▣ ENDPOINT 03 / 08

GET

Get Ingredient Substitutes by ID

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/substitutes

QUICKSTART

GUIDE

Quickstart

Fetch the substitutes for a food ingredient by ID.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/substitutes" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with ingredient and message string fields, plus a substitutes array of strings.

{
  "ingredient": "sugar",
  "substitutes": ["honey", "maple syrup"],
  "message": "Substitutes found"
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves substitute ingredients for a specific ingredient ID. The response returns a JSON object containing the ingredient name, a list of substitute ingredient names, and a message.

Path Parameter(s)

Attribute	Type	Description
id	Integer	Ingredient identifier.

Response

Returns a JSON object with message as a string, ingredient as a string, and substitutes as a string array.

Attribute	Type	Description
message	String	A non-empty message string.
ingredient	String	The ingredient name.
substitutes	String Array	Substitute ingredient names.

▣ ENDPOINT 04 / 08

GET

Ingredients by ID Image

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/recipes/:id/ingredientWidget.png

QUICKSTART

GUIDE

Quickstart

Fetch the recipe ingredient widget image for a recipe ID.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/recipes/:id/ingredientWidget.png" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a binary image response (string with format: binary)

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the ingredient widget image for a recipe identified by its numeric id. You can optionally choose the measurement system used in the image with the measure query parameter.

Path Parameter(s)

Attribute	Type	Description
id	Integer	The recipe identifier.

Query Parameter(s)

Attribute	Type	Description
measure	ENUM	Measurement system for the image. Allowed values: `us`, `metric`.

Response

Returns a binary string response containing the generated ingredient widget image for the requested recipe.

▣ ENDPOINT 05 / 08

POST

Map Ingredients to Grocery Products

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/map

QUICKSTART

GUIDE

Quickstart

Map a list of ingredients to product matches by sending the required ingredients and servings fields.

curl -X POST "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/map" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ingredients": ["tomato", "mozzarella"],
    "servings": 2
  }'

What you'll get back

Returns a JSON array of objects. Each item includes original, originalName, ingredientImage, meta (an array of strings), and products (an array of product objects with id, title, and upc).

[
  {
    "original": "tomato",
    "originalName": "Tomato",
    "ingredientImage": "https://example.com/tomato.png",
    "meta": ["fresh"],
    "products": [
      {
        "id": 123,
        "title": "Fresh Tomato",
        "upc": "012345678905"
      }
    ]
  }
]

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Maps a list of ingredient names to grocery products. You send the ingredients and servings in the request body, and the endpoint returns an array of matched ingredient records with product suggestions.

Request Body

Parameter	Type	Description
ingredients	String Array	Ingredient names to map to grocery products.
servings	Number	Number of servings used by the mapping operation.

Response

Returns a JSON array of objects. Each object includes original and originalName strings, an ingredientImage string, a meta string array, and a products object array; each product contains id as an integer plus title and upc strings. Success response shape: 200.

Parameter	Type	Description
original	String	Original ingredient value.
originalName	String	Original ingredient name.
ingredientImage	String	Image reference for the ingredient.
meta	String Array	Associated metadata strings.
products	Object Array	Matched grocery products for the ingredient. Each item includes `id`, `title`, and `upc`.
products[].id	Integer	Product identifier.
products[].title	String	Product title.
products[].upc	String	Product UPC.

Notes

The response is a unique array at both levels: the top-level result array is uniqueItems: true, and each products array is also uniqueItems: true.

▣ ENDPOINT 06 / 08

GET

Get Ingredient Substitutes

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/substitutes

QUICKSTART

GUIDE

Quickstart

Look up ingredient substitutes by passing the ingredient name as a query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/substitutes?ingredientName=butter" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with ingredient and message string fields, plus a substitutes array of strings.

{
  "ingredient": "butter",
  "substitutes": ["margarine", "ghee"],
  "message": "Substitutes found successfully"
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns ingredient substitute information for a given ingredient name. You provide the ingredient name as a query parameter, and the response comes back as a JSON object containing the original ingredient, a list of substitutes, and a message.

Query Parameter(s)

Attribute	Type	Description
ingredientName	String	The ingredient name to look up.

Response

Returns a JSON object with three required fields: message as a string, ingredient as a string, and substitutes as an array of strings. The success response is a JSON object with these top-level fields.

Attribute	Type	Description
message	String	A non-empty message string.
ingredient	String	A non-empty string identifying the ingredient that was looked up.
substitutes	String Array	An array of substitute ingredient names.

▣ ENDPOINT 07 / 08

GET

Compute Ingredient Amount

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/amount

QUICKSTART

GUIDE

Quickstart

Get the amount for a food ingredient by ID, using the required nutrient and target query parameters.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/:id/amount?target=2&nutrient=protein" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with amount as a number and unit as a string.

{
  "amount": 0.7,
  "unit": "oz"
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Computes the amount of the ingredient identified by id for a requested nutrient and target, with an optional unit query parameter. The response returns the calculated amount together with the unit used.

Path Parameter(s)

Attribute	Type	Description
id	Integer	The ingredient identifier.

Query Parameter(s)

Attribute	Type	Description
unit	String	The unit to use for the calculation.
target	Integer	The target value for the nutrient calculation.
nutrient	String	The nutrient to compute against.

Response

Returns a JSON object with amount as a number and unit as a string. These are the top-level fields in the success response.

Attribute	Type	Description
amount	Number	The computed amount.
unit	String	The unit used in the response.

▣ ENDPOINT 08 / 08

GET

Autocomplete Ingredient Search

https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/autocomplete

QUICKSTART

GUIDE

Quickstart

Search for matching ingredient names with the required query parameter.

curl -X GET "https://api.eu.apyhub.com/skycraft/food-ingredient-information-api/food/ingredients/autocomplete?query=burger" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of ingredient objects. Each object includes the required name and image fields, and may also include id, aisle, and possibleUnits.

[
  {
    "id": 1001,
    "name": "butter",
    "aisle": "Dairy",
    "image": "butter.jpg",
    "possibleUnits": ["stick", "tablespoon"]
  }
]

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a JSON array of ingredient suggestions matching the query search term. Each item in the array is an object with ingredient details as defined by the response schema.

Query Parameter(s)

Attribute	Type	Description
query	String	Search term used to find matching ingredients.
number	Integer	Maximum number of results to return. Default: `10`. Minimum: `1`, maximum: `100`.
language	ENUM	Response language. Allowed values: `en`, `de`.
intolerances	String	Intolerance filter passed as a query string.
metaInformation	Boolean	Whether to include meta information in the response.

Response

Returns a JSON array of ingredient objects. Each object may contain id as an integer, name as a non-empty string, aisle as a non-empty string, image as a non-empty string, and possibleUnits as an array of strings. The schema requires each item to include name and image.

Parameter	Type	Description
item.id	Integer	Ingredient identifier.
item.name	String	Ingredient name. Non-empty string.
item.aisle	String	Aisle name. Non-empty string.
item.image	String	Ingredient image reference. Non-empty string.
item.possibleUnits	String Array	Possible measurement units for the ingredient.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLFood Search & Trivia APISkycraft CALLIngredient Parser From Text APIIngredients API CALLExtract Product Information APIWebsite Intelligence CALLWine Pairing & Recommendations APISkycraft

From the blog

Reads that touch this API.

Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026 Web Data Extraction: Use Cases and ApproachesJul 9, 2026 What Is a Payload? Understanding API Payloads, Query Parameters, and API Tokens Sep 10, 2026 API Fundamentals: What an API Is and How to Use One Without Writing CodeSep 6, 2026