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

# Récupérer les recommandations de produits

> Obtenez des recommandations de produits personnalisées depuis la Product Recommendation API de Kameleoon en utilisant les codes de recommandation.

Cet endpoint récupère les recommandations de produits.

### Requête

```
GET https://api.products.kameleoon.com/recommend/{%recommender_code%}
```

### Paramètres de requête

| Paramètre          | Type             | Requis    | Description                                                                                                                                                                                                                                                                                                                                                      |
| :----------------- | :--------------- | :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `did`              | String           | True      | Device ID. Obtenez cet ID à partir du cookie `KameleoonProducts_device_id`. Récupérez-le depuis le backend avant d'appeler cet endpoint. Ne fournissez `did` que lorsque vous utilisez des filtres ou des algorithmes qui reposent sur des données historiques de l'appareil, comme "Recently Viewed" ou "Recommended for You."                                  |
| `shop_id`          | String           | True      | Store Key. Trouvez-le dans **Recommendations** > **Settings** > **Store settings** dans l'application Kameleoon. Contactez votre Customer Success Manager pour obtenir la clé si nécessaire.                                                                                                                                                                     |
| `sid`              | String           | True      | ID de session utilisateur temporaire. Obtenez cet ID à partir du cookie `KameleoonProducts_session_code`. Récupérez-le depuis le backend avant d'appeler cet endpoint. Ne fournissez `sid` que lorsque vous utilisez des filtres ou des algorithmes qui reposent sur des données historiques de l'utilisateur, comme "Recently Viewed" ou "Recommended for You." |
| `recommender_code` | String           | True      | ID du bloc de recommandations de produits. Trouvez le `recommender_code` dans l'interface utilisateur de gestion des blocs.                                                                                                                                                                                                                                      |
| `resize_image`     | Integer          | Optionnel | Taille de l'image (px) pour le redimensionnement. Valeurs prises en charge : `120`, `140`, `160`, `180`, `200`, `220`.                                                                                                                                                                                                                                           |
| `extended`         | Integer or empty | Optionnel | Ajoute des informations étendues pour les produits recommandés. Si `1`, l'API renvoie toutes les informations sur le produit. Si vide, l'API ne renvoie que les IDs des produits.                                                                                                                                                                                |
| `with_locations`   | Boolean          | False     | Si `true` et que le paramètre `extended` est également `true`, la réponse inclut `location_ids` pour tous les lieux de disponibilité. Si `extended` est manquant ou `false`, l'API ignore `with_locations` et utilise `false` par défaut.                                                                                                                        |

### Réponse

| Nom          | Type   | Description                                                                                            |
| :----------- | :----- | :----------------------------------------------------------------------------------------------------- |
| `html`       | string | Code HTML pour le bloc de produits. Personnalisez le template HTML dans le compte personnel Kameleoon. |
| `title`      | string | Titre du bloc. Correspond à la valeur de l'élément "Action" dans les règles du bloc.                   |
| `recommends` | array  | Liste des IDs des produits.                                                                            |
| `id`         | number | Identifiant unique du bloc. Correspond à l'ID du bloc dans le compte personnel Kameleoon.              |