Obtain a Recipe Feed

The Recipe Feed is similar to a Recipe Search but is intended to be more discovery-oriented. While a search may target a specific type of recipe, the feed will return an infinite number of results and can be personalized according to specific user preferences

This section is incomplete and currently a work in progress.

get
Recipe Feed

https://api.whisk.com/feed/v2/get
Request
Response
Request
Path Parameters
Feed Request
optional
object
Response
200: OK
{
"feed_id": "string",
"items": [
{
"key": {
"id": "string"
},
"display": {
"display_name": "string",
"images": [
{
"responsive": {
"url": "string",
"width": 0,
"height": 0
},
"url": "string"
}
],
"tag": {
"name": "string",
"display_name": "string",
"image": {
"url": "string",
"width": 0,
"height": 0
}
}
},
"content": {
"recipe": {
"id": "string",
"name": "string",
"description": "string",
"images": [
{
"responsive": {
"url": "string",
"width": 0,
"height": 0
},
"url": "string"
}
],
"videos": [
{
"content_url": "string",
"embed_url": "string",
"thumbnail": "string"
}
],
"source": {
"name": "string",
"display_name": "string",
"source_recipe_url": "string",
"image": {
"responsive": {
"url": "string",
"width": 0,
"height": 0
},
"url": "string"
},
"license": "LICENCE_INVALID"
},
"saved": {
"value": true,
"collection_ids": [
"string"
],
"owner": true,
"recipe_type": "RECIPE_TYPE_INVALID"
},
"author": {
"name": "string",
"image": {
"responsive": {
"url": "string",
"width": 0,
"height": 0
},
"url": "string"
}
},
"custom_labels": [
{
"name": "string",
"labels": [
{
"name": "string"
}
]
}
]
}
}
}
],
"cursor": {
"cursors": {
"after": "string",
"before": "string"
},
"total": "string"
}
}

This endpoint provides a Feed that contains recipes by default and other times of data based on the supplied parameters.

{
"feed_id": "string",
"country": "string",
"language": "string",
"with_saved_info": true,
"cursor": {
...
},
"labels": [
...
],
"exclude_ingredients": [
...
],
"feed_tags": [
...
],
"custom_labels": {
...
}
}

Attribute

Type

Description

feed_id

string

country

string

language

string

with_saved_info

bool

cursor

object

labels

array

exclude_ingredients

array

feed_tags

array

custom_labels

object

Cursor

"cursor": {
"limit": 0,
"cursors": {
"after": "string",
"before": "string"
}
},

Labels

"labels": [
{
"label": {
"diet": "DIET_INVALID",
"category": "CATEGORY_INVALID",
"avoidance": "AVOIDANCE_INVALID",
"cuisine": "CUISINE_INVALID",
"meal_type": "MEAL_TYPE_INVALID",
"nutrition": "NUTRITION_INVALID",
"feature": "string",
"holiday": "HOLIDAY_INVALID",
"seasonality": "SEASONALITY_INVALID"
},
"boost": true
}
],

Diet

Enum

DIET_INVALID

DIET_VEGETARIAN

DIET_VEGAN

DIET_OVO_VEGETARIAN

DIET_LACTO_VEGETARIAN

DIET_OVO_LACTO_VEGETARIAN

DIET_PESCATARIAN

DIET_KETOGENIC

DIET_DETOX

DIET_PALEO

DIET_DAIRY_FREE

Category

Enum

CATEGORY_INVALID

CATEGORY_QUICK_AND_EASY

CATEGORY_HEALTHY_RECIPES

CATEGORY_HOLIDAYS_AND_EVENTS

CATEGORY_BAKING

CATEGORY_BBQ_AND_GRILLING

CATEGORY_MAIN_DISHES

CATEGORY_SIDE_DISHES

CATEGORY_DESSERTS

CATEGORY_DRINKS

CATEGORY_APPETIZERS_AND_SNACKS

CATEGORY_LUNCH

CATEGORY_DINNER

CATEGORY_MEAT_AND_POULTRY

CATEGORY_PASTA

CATEGORY_SALAD

CATEGORY_SEAFOOD

CATEGORY_SOUPS_AND_STEWS

Avoidance

Enum

AVOIDANCE_INVALID

AVOIDANCE_ALCOHOL

AVOIDANCE_CAFFEINE

AVOIDANCE_CELERY

AVOIDANCE_CRUSTACEAN

AVOIDANCE_EGG

AVOIDANCE_FISH

AVOIDANCE_GLUTEN

AVOIDANCE_GROUNDNUT

AVOIDANCE_MILK

AVOIDANCE_MOLLUSC

AVOIDANCE_MUSTARD

AVOIDANCE_SESAME

AVOIDANCE_SOYBEAN

AVOIDANCE_SULPHITES

AVOIDANCE_TREE_NUT

AVOIDANCE_WHEAT

AVOIDANCE_YEAST

AVOIDANCE_LACTOSE

Cuisine

Enum

CUISINE_INVALID

CUISINE_AFRICAN

CUISINE_AMERICAN

CUISINE_ASIAN

CUISINE_AUSTRALIAN

CUISINE_BRITISH

CUISINE_CAJUN_AND_CREOLE

CUISINE_CANADIAN

CUISINE_CARIBBEAN

CUISINE_CHINESE

CUISINE_CUBAN

CUISINE_EASTERN_EUROPEAN

CUISINE_EUROPEAN

CUISINE_FRENCH

CUISINE_GERMAN

CUISINE_GREEK

CUISINE_INDIAN

CUISINE_ISRAELI

CUISINE_ITALIAN

CUISINE_JAPANESE

CUISINE_KOREAN

CUISINE_LATIN_AMERICAN

CUISINE_MEDITERRANEAN

CUISINE_MEXICAN

CUISINE_MIDDLE_EASTERN

CUISINE_MOROCCAN

CUISINE_PORTUGUESE

CUISINE_SOUTHERN

CUISINE_SPANISH

CUISINE_TEX_MEX

CUISINE_THAI

CUISINE_VIETNAMESE

CUISINE_WORLD_CUISINE

Meal Type

Enum

MEAL_TYPE_INVALID

MEAL_TYPE_APERITIF

MEAL_TYPE_APPETIZERS

MEAL_TYPE_BEVERAGES

MEAL_TYPE_BREADS

MEAL_TYPE_BREAKFAST

MEAL_TYPE_BRUNCH

MEAL_TYPE_COCKTAILS

MEAL_TYPE_CONDIMENTS_AND_SAUCES

MEAL_TYPE_DESSERTS

MEAL_TYPE_DINNER

MEAL_TYPE_JUICES

MEAL_TYPE_LUNCH

MEAL_TYPE_MAIN_COURSE

MEAL_TYPE_SALADS

MEAL_TYPE_SIDE_DISHES

MEAL_TYPE_SMOOTHIES

MEAL_TYPE_SNACKS

MEAL_TYPE_SOUPS_AND_STEWS

Nutrition

Enum

NUTRITION_INVALID

NUTRITION_CHOLESTEROL_FREE

NUTRITION_DIABETES_FRIENDLY

NUTRITION_FAT_FREE

NUTRITION_HEALTHY

NUTRITION_HIGH_FIBER

NUTRITION_HIGH_MONOUNSATURATED_FAT

NUTRITION_HIGH_POLYUNSATURATED_FAT

NUTRITION_HIGH_PROTEIN

NUTRITION_HIGH_UNSATURATED_FAT

NUTRITION_LOW_CARB

NUTRITION_LOW_CHOLESTEROL

NUTRITION_LOW_ENERGY

NUTRITION_LOW_FAT

NUTRITION_LOW_SALT

NUTRITION_LOW_SATURATED_FAT

NUTRITION_LOW_SODIUM

NUTRITION_LOW_SUGARS

NUTRITION_SALT_FREE

NUTRITION_SATURATED_FAT_FREE

NUTRITION_SODIUM_FREE

NUTRITION_SOURCE_OF_FIBER

NUTRITION_SOURCE_OF_PROTEIN

NUTRITION_SUGARS_FREE

NUTRITION_VERY_LOW_SALT

NUTRITION_VERY_LOW_SODIUM

Feature

This accepts a string value

Holiday

Enum

HOLIDAY_INVALID

HOLIDAY_BURNS_NIGHT

HOLIDAY_VALENTINES_DAY

HOLIDAY_PANCAKE_DAY

HOLIDAY_SAINT_DAVIS_DAY

HOLIDAY_SAINT_PATRICKS_DAY

HOLIDAY_EASTER_DAY

HOLIDAY_CINCO_DE_MAYA

HOLIDAY_MEMORIAL_DAY

HOLIDAY_INDEPENDENCE_DAY

HOLIDAY_LABOR_DAY

HOLIDAY_DIWALI

HOLIDAY_HALLOWEEN

HOLIDAY_THANKSGIVING_DAY

HOLIDAY_CHRISTMAS

HOLIDAY_BOXING_DAY

HOLIDAY_NEW_YEAR

HOLIDAY_MOTHERS_DAY

HOLIDAY_PASSOVER

HOLIDAY_FATHERS_DAY

HOLIDAY_ROSH_HASHANAH

HOLIDAY_YOM_KIPPUR

HOLIDAY_HANNUKAH

Seasonality

Enum

SEASONALITY_INVALID

SEASONALITY_WINTER

SEASONALITY_SPRING

SEASONALITY_SUMMER

SEASONALITY_FALL

Exclude Ingredients

"exclude_ingredients": [
"string"
],

Feed Tags

"feed_tags": [
"FEED_TAG_INVALID"
],

Enum

FEED_TAG_INVALID

FEED_TAG_EASY_DINNERS

FEED_TAG_DINNERS

FEED_TAG_TRENDING

FEED_TAG_RECOMMENDED

FEED_TAG_HEALTHY

FEED_TAG_HOLIDAYS

FEED_TAG_SEASONAL

Custom Labels

"custom_labels": {
"everywhere": {
"in": [
{
"group": "string",
"label": "string"
}
],
"boost_in": [
{
"group": "string",
"label": "string"
}
]
},
"in_recipe": {
"in": [
{
"group": "string",
"label": "string"
}
],
"boost_in": [
{
"group": "string",
"label": "string"
}
]
},
"in_ingredients": {
"in": [
{
"group": "string",
"label": "string"
}
],
"boost_in": [
{
"group": "string",
"label": "string"
}
]
},
"in_instruction_steps": {
"in": [
{
"group": "string",
"label": "string"
}
],
"boost_in": [
{
"group": "string",
"label": "string"
}
]
}
}

Sample Request

curl "https://api.whisk.com/v2/feed?limit=5&allowedContent=link,group,recipe" \
-H "Accept: application/json" \
-H "Authorization: Token <Access-Token>"