Get ingredient sponsored products for a recipe
Fetch all sponsored products explicitly linked to the ingredients of a specific recipe. By targeting a single recipe, you can instantly resolve which branded SKUs should be natively placed when the user is viewing that specific dish. The perfect tool for precisely timed retail media placements. Use Cases: CONTEXTUAL PRODUCT PLACEMENT • User views 'Classic Tiramisu' recipe → 'Brand Y Mascarpone' appears next to ingredient list as sponsored suggestion. High conversion at peak purchase intent. RESTAURANTS — SUPPLIER PARTNERSHIPS • Restaurant shows supplier products next to recipe ingredients in digital menu. Ad revenue from suppliers. 1-CLICK 'BUY THE RECIPE' • Power the 'Add all to cart' button with sponsored SKUs configured in the backoffice. Profitable cart aligned with the recipe.
Response
IngredientSponsoredProductArray
object[]
IngredientSponsoredProductArray
IngredientSponsoredProduct
A recipe ingredient linked to a sponsored product
object
IngredientSponsoredProduct
A recipe ingredient linked to a sponsored product
recipeIngredientId
Unique identifier for this ingredient entry
recipeId
Identifier of the recipe this ingredient belongs to
name
Display name of the ingredient
quantity?
Quantity of the ingredient used
measureUnitId?
Unit of measure identifier for the quantity; resolvable via GET /definitions/measure-units
unitQuantity
Unit quantity of the sponsored product
priority
Recommendation rank of this product for the ingredient, where the lowest value is the best match and ranking starts at 1. Consistent with formatScore: as priority grows the score never grows, and products with no score come last. Ranks may skip values, because a product that has no data in the requested language is left out of the response.
formatScore?
Format compatibility score, from 0.01 to 100: the percentage of what you buy that the recipe actually uses. 100 means the pack size matches the required quantity exactly, 50 means you buy twice what you need. Products with the same score are equally compatible in terms of format, so use priority to pick among them — except at 0.01, where the scale saturates and only tells you the pack is far too large. Null when compatibility cannot be assessed: the product weight is unknown, the ingredient quantity has no gram equivalent (such as to taste), or the association predates this field and has not been recomputed yet. Volumes are treated as 1 ml = 1 g.
productId
Identifier of the sponsored product
shopProductId?
Shop-specific identifier for the product
productName
Name of the sponsored product
brand
Brand of the sponsored product
ean?
EAN barcode of the product
format?
Packaging format of the product
weightGrams?
Weight of the product in grams
imageUrl?
Image url of the product
Unauthorized
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Forbidden
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Not Acceptable
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Unprocessable Entity
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Too Many Requests (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Internal Server Error
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Bad Gateway (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?
Gateway Timeout (APIM)
ConnectProblemDetails
object
ConnectProblemDetails
type?
title?
status?
detail?
instance?
requestId?
traceId?