Spoonacular

Spoonacular is a food knowledge platform covering recipe discovery, ingredient parsing, meal planning, and detailed nutritional analysis, well suited for health and wellness campaign personalisation.

MoEngage <> Spoonacular

The MoEngage <> Spoonacular integration allows you to personalise food, health, and grocery campaigns with live recipe and nutrition data at send time. Common use cases include recommending recipes based on a user's dietary preferences, surfacing healthy meal ideas in a wellness app, or promoting grocery products with recipe inspiration.

Integration

library_add_check

Prerequisites

Ensure you have a Spoonacular account with an active API key. Free keys are available at spoonacular.com/food-api. The free tier allows 150 points per day.

Step 1: Get your Spoonacular API key

Navigate to spoonacular.com/food-api and create a free account.
Your API key is displayed on your console dashboard. Copy it.

Step 2: Set up the Content API on MoEngage

Navigate to Dashboard > Settings > APIs and open the Content API tab.
Click Add Content API.
Fill in the details using the table below as a reference.

Key Value

Name Choose a descriptive name, for example Spoonacular Recipe Search.

Method GET

API URL

https://api.spoonacular.com/recipes/complexSearch

Refer to the Spoonacular documentation for all endpoints.

Key Value Parameters

Parameter	Example value	Notes
`apiKey`	Your API key	Required for every request.
`diet`	`@user.diet_preference`	Filter by diet: `vegetarian`, `vegan`, `gluten free`, `ketogenic`, etc.
`cuisine`	`@user.cuisine_preference`	Filter by cuisine type.
`number`	`3`	Number of results to return.
`addRecipeInformation`	`true`	Set to `true` to include image, title, and summary in the response.

Click Validate to confirm the platform returns a response, then click Save.

Once saved, refer to the MoEngage documentation on using Content APIs in campaigns to learn how to reference response fields inside your campaign templates.

Understanding the API response

The response contains a results array. Each object represents one recipe.

Response field	Template variable example	Description
`results[0].title`	`{{ContentApi.results[0].title}}`	Recipe name.
`results[0].image`	`{{ContentApi.results[0].image}}`	Recipe photo URL.
`results[0].readyInMinutes`	`{{ContentApi.results[0].readyInMinutes}}`	Preparation time in minutes.
`results[0].servings`	`{{ContentApi.results[0].servings}}`	Number of servings.
`results[0].sourceUrl`	`{{ContentApi.results[0].sourceUrl}}`	Full recipe URL — use as a CTA.