Endpoint Playground
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.
14 Oct 2026: 2 shelves; 3 fields had a value in every checked item.
Sample value profiles: name: “keep_exploring” and 1 other value; products: median 4 entries.
curl 'https://api.crawlora.net/api/v1/hermes/product/recommendations?sku=H252013Z+BM&locale=at_de' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| sku | string | Yes | H252013Z BM | Hermès product sku, in any of the forms hermes-product accepts |
| locale | string | No | at_de | Market and language. One of: 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 |
{
"code": 200,
"msg": "ok",
"data": {
"locale": "us_en",
"sku": "H252013Z BM360",
"shelves": [
{
"name": "perfect_partner",
"total": 4,
"products": [
{
"sku": "H410001F 8553",
"title": "Uni ring, medium model",
"url": "https://www.hermes.com/us/en/product/uni-ring-H410001Fv85/",
"price": 475,
"currency": "USD",
"in_stock": true,
"images": [
"https://assets.hermes.com/is/image/hermesproduct/410001F%2085_front_wm_1"
]
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.