Get Recipe Categories

This endpoint allows getting all available categories for a specific language.

Get Recipe Categories

POST https://graph.whisk.com/v1/recipes/categories

Path Parameters

Name	Type	Description
country	string	Country ISO code. Default is gb
limit	number	Number of categories

200

{
  "categories": [
    {
      "id": "quick-and-easy",
      "displayName": "Quick and easy",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "healthy-recipes",
      "displayName": "Healthy Recipes",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "holidays-and-events",
      "displayName": "Holidays and Events",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "baking",
      "displayName": "Baking",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    },
    {
      "id": "bbq-and-grilling",
      "displayName": "BBQ & Grilling",
      "image": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523894700/custom_upload/ba4d7363cd46c736675d2cc08754f5bc.png",
        "width": 800,
        "height": 800
      }
    }
  ],
  "paging": {
    "cursors": {
      "after": "eyJpZCI6ImRlc3NlcnRzIiwiaW5kZXgiOjR9"
    }
  }
}

Sample Request

curl "https://graph.whisk.com/v1/recipes/categories?country=gb&limit=5" \
    -H "Accept: application/json" \
    -H "Authorization: Token <Access-Token>"

Response

The result is a list of all available categories corresponding to the required region. You can use these categories for filtering recipes in search.

ATTRIBUTE	TYPE	DESCRIPTION
categories*	array [RecipeCategory]
paging	Paging

RecipeCategory

ATTRIBUTE	TYPE	DESCRIPTION
id*	string
displayName*	string
image	ResponsiveImage

Paging

ATTRIBUTE	TYPE	DESCRIPTION
cursors*	Cursors

Cursors

ATTRIBUTE	TYPE	DESCRIPTION
after	string
before	string