Recipe recommendations for SH
A method to fetch a set of recipes supporting a certain calorie goal
Last updated
A method to fetch a set of recipes supporting a certain calorie goal
Last updated
To provide diversity across recommended recipes result is shuffled for every request.
We return recipes with calories per serving matching the range from 85% to 120% from requested
Recommended integration flow is below. Let us know if it's not possible
GET
https://samsung-health-api.whisk.com/health/recipe/v2/search?
{
"recipes": [
{
"id": "107d638402cd5cd4dcbae589a0032668444",
"title": "French toast by Lau",
"image": {
"url": "https://cloudinary-cdn.whisk.com/image/upload/v1592914668/recipe/61010b3adc018e6ab6aae7051771901f.jpg"
},
"nutrition": {
"nutrition": [
{
"amount": 1.0110000000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_NIA"
},
{
"amount": 0.05,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FATRN"
},
{
"amount": 212.29,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_CHOCDF"
},
{
"amount": 800.76,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_CHOLE"
},
{
"amount": 593.9530000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_P"
},
{
"amount": 326.521,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITA_RAE"
},
{
"amount": 6.072,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITD"
},
{
"amount": 74.66499999999999,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_MG"
},
{
"amount": 0.652,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_VITB6A"
},
{
"amount": 4.7219999999999995,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITK1"
},
{
"amount": 58.717999999999996,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_PROCNT"
},
{
"amount": 27.552,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_VITC"
},
{
"amount": 460.392,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_CA"
},
{
"amount": 83.40100000000001,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_FOL"
},
{
"amount": 2.978,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAPU"
},
{
"amount": 71.81699999999998,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_SUGAR"
},
{
"amount": 1760.569,
"unit_name": "NUTRITION_UNIT_KCAL",
"code": "NUTRITION_CODE_ENERC_KCAL"
},
{
"amount": 17.968,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FIBTG"
},
{
"amount": 69.349,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAT"
},
{
"amount": 926.807,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_K"
},
{
"amount": 1551.4779999999996,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_NA"
},
{
"amount": 3.1229999999999998,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_ZN"
},
{
"amount": 33.238,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FASAT"
},
{
"amount": 1.7710000000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_TOCPHA"
},
{
"amount": 1.0949999999999998,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_RIBF"
},
{
"amount": 2.827,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITB12"
},
{
"amount": 0.269,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_THIA"
},
{
"amount": 2.662,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_FE"
},
{
"amount": 6.9799999999999995,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAMS"
}
]
},
"recipe_link": "https://app.samsungfood.com/recipes/107d638402cd5cd4dcbae589a0032668444",
"number_of_servings": 4
},
...
]
}
{
"code": "general.badRequest",
"message": "language is incorrect"
}
{
// Response
}
{
// Response
}
https://api.whisk.com/spec/#/HealthyRecipeAPI/HealthyRecipeAPI_Search
The example below requests five Breakfast options around 400 kcal in English language. All fields are requested.
curl -X GET "https://api.whisk.com/health/recipe/v2/search?meal_time=MEAL_TIME_BREAKFAST&calories=400&language=en&country=gb&limit=5&response_mask.paths=id&response_mask.paths=title&response_mask.paths=image&response_mask.paths=nutrition&response_mask.paths=recipe_link&response_mask.paths=number_of_servings" -H "accept: application/json" -H "Authorization: Token %TOKEN%"
Data returned in JSON. Empty strings, zero values, empty arrays and null values are not returned.
{
"recipes": [
{
"id": "107d638402cd5cd4dcbae589a0032668444",
"title": "French toast by Lau",
"image": {
"url": "https://cloudinary-cdn.whisk.com/image/upload/v1592914668/recipe/61010b3adc018e6ab6aae7051771901f.jpg"
},
"nutrition": {
"nutrition": [
{
"amount": 1.0110000000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_NIA"
},
{
"amount": 0.05,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FATRN"
},
{
"amount": 212.29,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_CHOCDF"
},
{
"amount": 800.76,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_CHOLE"
},
{
"amount": 593.9530000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_P"
},
{
"amount": 326.521,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITA_RAE"
},
{
"amount": 6.072,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITD"
},
{
"amount": 74.66499999999999,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_MG"
},
{
"amount": 0.652,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_VITB6A"
},
{
"amount": 4.7219999999999995,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITK1"
},
{
"amount": 58.717999999999996,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_PROCNT"
},
{
"amount": 27.552,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_VITC"
},
{
"amount": 460.392,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_CA"
},
{
"amount": 83.40100000000001,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_FOL"
},
{
"amount": 2.978,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAPU"
},
{
"amount": 71.81699999999998,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_SUGAR"
},
{
"amount": 1760.569,
"unit_name": "NUTRITION_UNIT_KCAL",
"code": "NUTRITION_CODE_ENERC_KCAL"
},
{
"amount": 17.968,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FIBTG"
},
{
"amount": 69.349,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAT"
},
{
"amount": 926.807,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_K"
},
{
"amount": 1551.4779999999996,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_NA"
},
{
"amount": 3.1229999999999998,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_ZN"
},
{
"amount": 33.238,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FASAT"
},
{
"amount": 1.7710000000000001,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_TOCPHA"
},
{
"amount": 1.0949999999999998,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_RIBF"
},
{
"amount": 2.827,
"unit_name": "NUTRITION_UNIT_MKG",
"code": "NUTRITION_CODE_VITB12"
},
{
"amount": 0.269,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_THIA"
},
{
"amount": 2.662,
"unit_name": "NUTRITION_UNIT_MG",
"code": "NUTRITION_CODE_FE"
},
{
"amount": 6.9799999999999995,
"unit_name": "NUTRITION_UNIT_G",
"code": "NUTRITION_CODE_FAMS"
}
]
},
"recipe_link": "https://app.samsungfood.com/recipes/107d638402cd5cd4dcbae589a0032668444",
"number_of_servings": 4
},
...
]
}
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|