Get a recipe

Retrieve the complete, in-depth details of a specific recipe by its identifier. This includes steps, ingredients, nutritional values, and media, providing everything needed to render a rich, interactive cooking experience on your platform. Built for blazing-fast retrieval, it powers the main recipe detail pages of your application. Use Cases: INTERACTIVE COOKING MODE • Power a step-by-step, distraction-free cooking mode in your app with precise timings, instructions, and media assets. Integrable with voice assistants. E-COMMERCE — ENRICHED PRODUCT PAGES • Embed the full recipe on product pages where the product is a key ingredient. Users add all ingredients to cart from the recipe view. RESTAURANTS — INTERACTIVE DIGITAL MENU • Customer scans the dish QR code and sees the full recipe: ingredients, preparation, nutritional values. FOOD DELIVERY KITS • Digital instruction manual for physical meal kits. Customer scans the QR on the box and views step-by-step recipe.

GET
/recipes/{recipeId}
Recipes
No credits required
Get API KeyView pricing

Generate purchasable product matches from recipe ingredients

POST /recipes-to-cart

Get ingredient sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/ingredients

Response

200
application/json
object

RecipeDetail

Full details of a recipe

object

recipeId

Unique identifier for the recipe

integer<int32>

title?

Localized title of the recipe

string | null

slug

URL-friendly slug of the recipe

string

difficulty?

Difficulty level identifier; resolvable via GET /definitions/difficulties

integer<uint8> | null

cookingTimeMinutes?

Cooking time in minutes

integer<int32> | null

preparationTimeMinutes?

Preparation time in minutes

integer<int32> | null

recipeTypeId

Recipe type identifier; resolvable via GET /definitions/recipe-types

integer<int16>

servings

Number of servings the recipe yields

integer<int16>

countryId?

Country of origin identifier; resolvable via GET /definitions/countries

integer<int32> | null

italianRegionId?

Italian region of origin identifier; resolvable via GET /definitions/italian-regions

integer<int32> | null

description?

Localized description of the recipe

string | null

otherInfos?

Additional localized notes or information about the recipe

string | null

storageInstructions?

Localized storage and conservation instructions

string | null

isPublished

Whether the recipe is published

boolean

isDeleted

Whether the recipe has been soft-deleted

boolean

totalTimeMinutes?

Sum of cooking and preparation time in minutes

integer<int32> | null

imageUrl?

URL of the recipe cover image

string | null

preparationSteps?

string[]
string

links?

object[]

NamedLink

object

name

string

url

string

ingredients?

object[]

All of

Variant 1

object[]

RecipeIngredient

An ingredient entry in a recipe with quantity

object

recipeIngredientId?

Unique identifier for this ingredient entry

integer<int32>

recipeId?

Identifier of the recipe this ingredient belongs to

integer<int32>

name?

Display name of the ingredient

string | null

quantity?

Quantity of the ingredient used

number<double> | null

measureUnitId?

Unit of measure identifier for the quantity; resolvable via GET /definitions/measure-units

integer<int32> | null

isIngredient?

True if this is an ingredient; false if it is a generic item or note

boolean

suggestions?

object[]

All of

Variant 1

object[]

RecipeTool

A tool or piece of equipment needed for a recipe

object

recipeToolId?

Unique identifier for this tool entry

integer<int32>

recipeId?

Identifier of the recipe this tool belongs to

integer<int32>

name

Display name of the tool

string
204
application/json

No Content

No schemas are available for this endpoint.

401
application/json
object

Unauthorized

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
403
application/json
object

Forbidden

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
406
application/json
object

Not Acceptable

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
422
application/json
object

Unprocessable Entity

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
429
application/json
object

Too Many Requests (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
500
application/json
object

Internal Server Error

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
502
application/json
object

Bad Gateway (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string
504
application/json
object

Gateway Timeout (APIM)

ConnectProblemDetails

object

type?

string

title?

string

status?

integer<int32>

detail?

string

instance?

string

requestId?

string

traceId?

string

Generate purchasable product matches from recipe ingredients

POST /recipes-to-cart

Get ingredient sponsored products for a recipe

GET /recipes/{recipeId}/sponsored-products/ingredients