---
title: "Get a Hermès product's recommended items"
method: GET
path: "/hermes/product/recommendations"
tags: ["Hermes"]
---

# Get a Hermès product's recommended items

`GET /hermes/product/recommendations`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/hermes/product/recommendations`
- Auth: API key in header `x-api-key`

Returns the cross-sell shelves Hermès shows on a product page: "keep exploring" (similar items) and "perfect partner" (items styled with it), each a list of products with price, stock and image. Takes the same sku forms as hermes-product. A product Hermès offers no recommendations for returns an empty shelves list rather than an error.

## Query parameters

- `sku` string, required
- `locale` 'at_de' | 'au_en' | 'be_en' | 'be_fr' | 'br_pt' | 'ca_en' | 'ca_fr' | 'ch_de' | 'ch_fr' | 'cz_en' | 'de_de' | 'dh_en' | 'dk_en' | 'es_es' | 'fi_en' | 'fr_fr' | 'gr_en' | 'hk_en' | 'ie_en' | 'it_it' | 'jp_ja' | 'kr_ko' | 'lu_fr' | 'mo_en' | 'mx_es' | 'my_en' | 'nl_en' | 'no_en' | 'pl_en' | 'pt_en' | 'ri_en' | 'se_en' | 'sg_en' | 'th_en' | 'tw_zh' | 'uk_en' | 'us_en'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HermesRecommendationsResponseDoc
  - `code` integer
  - `data` HermesRecommendationsResponse
    - `locale` string
    - `shelves` HermesShelf[]
      - `name` string
      - `products` HermesProduct[]
        - `color` string
        - `colorless` boolean
        - `currency` string
        - `department_code` string
        - `division_code` string
        - `family_code` string
        - `images` string[]
        - `in_stock` boolean
        - `in_store` boolean
        - `more_colors` boolean
        - `personalizable` boolean
        - `price` number
        - `price_type` string
        - `product_code` string
        - `size` string
        - `sku` string
        - `slug` string
        - `title` string
        - `url` string
      - `total` integer
    - `sku` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)