> ## 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.

# 商品レコメンデーションの取得

> レコメンダーコードを使用して、Kameleoon Product Recommendation API からパーソナライズされた商品レコメンデーションを取得します。

このエンドポイントは商品レコメンデーションを取得します。

### リクエスト

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

### クエリパラメーター

| パラメーター             | 型                | 必須       | 説明                                                                                                                                                                                                        |
| :----------------- | :--------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `did`              | String           | True     | デバイス ID。`KameleoonProducts_device_id` クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。"Recently Viewed" や "Recommended for You" など、過去のデバイスデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ `did` を提供します。             |
| `shop_id`          | String           | True     | ストアキー。Kameleoon アプリの **Recommendations** > **Settings** > **Store settings** で確認できます。必要に応じてカスタマーサクセスマネージャーにキーをお問い合わせください。                                                                                 |
| `sid`              | String           | True     | 一時的なユーザーセッション ID。`KameleoonProducts_session_code` クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。"Recently Viewed" や "Recommended for You" など、過去のユーザーデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ `sid` を提供します。 |
| `recommender_code` | String           | True     | 商品レコメンデーションブロックの ID。`recommender_code` はブロック管理 UI で確認できます。                                                                                                                                                |
| `resize_image`     | Integer          | Optional | リサイズ用の画像サイズ(px)。サポートされる値: `120`、`140`、`160`、`180`、`200`、`220`。                                                                                                                                            |
| `extended`         | Integer or empty | Optional | 推奨商品の拡張情報を追加します。`1` の場合、API はすべての商品情報を返します。空の場合、API は商品 ID のみを返します。                                                                                                                                       |
| `with_locations`   | Boolean          | False    | `true` で、かつ `extended` パラメーターも `true` の場合、レスポンスにはすべての在庫場所の `location_ids` が含まれます。`extended` が指定されていないか `false` の場合、API は `with_locations` を無視し、デフォルトで `false` になります。                                      |

### レスポンス

| 名前           | 型      | 説明                                                          |
| :----------- | :----- | :---------------------------------------------------------- |
| `html`       | string | 商品ブロックの HTML コード。Kameleoon の個人アカウントで HTML テンプレートをカスタマイズします。 |
| `title`      | string | ブロックのタイトル。ブロックルールの "Action" 要素の値と一致します。                     |
| `recommends` | array  | 商品 ID のリスト。                                                 |
| `id`         | number | 一意のブロック識別子。Kameleoon の個人アカウントのブロック ID と一致します。               |