---
title: "Recommendation REST API - Get Started"
slug: "recommendation-rest-api-get-started"
updated: 2024-12-12T14:39:19Z
published: 2024-12-12T14:39:19Z
canonical: "docs.mapp.com/recommendation-rest-api-get-started"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommendation REST API - Get Started

Mapp's API for recommendations is a REST interface. All authorized customers can access recommendation items through this API. The first part of this documentation describes how to set up the API in Marketing Automation and which conditions must be met to use it. In the second part, you learn how to [send API requests](/v1/docs/using-the-recommendation-api).

> We also offer the [REST API documentation in Apiary](https://webtrekkapi.docs.apiary.io/#reference). This allows you to test supported operations in an interactive console. An integrated Mock API framework allows you to read in sample input parameters for the operations and the output data model (JSON output).

## Requirements

Before you can work with the API, the following requirements must be met:

- Marketing Automation must be configured and activated for your Mapp Intelligence account.
- A product catalog must be imported into Mapp Q3 and made available in Marketing Automation.
- The REST API for recommendations must be enabled for your Marketing Automation account.

---

## Setup of the API in Marketing Automation

To set up the Recommendations API in Mapp Marketing Automation you must create a Recommendation API placement, a campaign and call the Audience API information.

### Create a Recommendation API Placement

Follow these steps:

1. Log in to your Mapp Intelligence account.
2. Open Marketing Automation by switching to the tab **Marketing** in the toolbar. You will be forwarded to the Marketing Automation module. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/fd634db2-d18c-49e3-a4f3-bdc95e9509ff.png)
3. In the navigation panel on the left side, click *Placements > Reco API* > *Create* and enter a unique name for your API placement, and click **Next**. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/76953ec8-38eb-449b-9e6c-e6bf652b5239.png)
4. Under **Configuration for recommendations**, specify the parameters: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/a900a70e-6e11-4b1a-92b1-f6c2e779dd83.png)

| Parameter | Description |
| --- | --- |
| Recommendation count (10) | Define the max. amount of products per response. |
| Item categories | Select the required categories that should be included in the response. |
| Control group | **Size in %**: Define the control group size in percent. **Content**: Click the corresponding radio button to define whether these users should see fallback items (**Top Sellers of Shop**) or no items at all. |
| Blacklist | Use this option to select products to exclude from recommendations. |
5. Click **Save**. The new placement setting is saved and appears in the list of existing Reco API placements.

### Create a Campaign

After you have created a Recommendation API placement as described in the first step, you can now configure campaigns for this placement. Find more information here: [Marketing Automation](/v1/docs/marketing-automation).

### Call API Information

To send the required requests using the API, you need the information about the interface, such as the URL, placement ID, and the required query parameters. In the Marketing Automation module in the Mapp Intelligence Suite, you can open an info box with all the necessary information on the individual Reco API placements.

1. In the navigation panel on the left side, click *Placements > Reco API*. The overview of all available Reco API placements appears.
2. To open the API info box, click ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/832247b3-9a9e-43fe-aa46-799d49ff6d7c.png) of the desired API placement. The dialog box **Get API information** opens including the following information:
  - **Placement ID**
  - **URL**
  - **Campaign Name**
  - **Input Keys (query parameters)** ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/b2d96a5b-c1c9-4038-ac6a-1cbe8e344a54.png)
3. Copy the necessary information for your API requests (see [API via the Mapp Server](/v1/docs/using-the-recommendation-api)).

[Using the Recommendation API](/v1/docs/using-the-recommendation-api)

## Related

- [Marketing Automation](/marketing-automation.md)