Endpoint Playground
Returns Hermès' own search-box autocomplete for a partial term: matching categories with the number of items behind each, and matching products. The category codes returned are the same codes hermes-category accepts, so a suggestion feeds straight into a category browse. An empty query is supported and returns Hermès' default suggestions rather than an error.
14 Oct 2026: 10 products; 3 fields had a value in every checked item.
Sample value profiles: label: Tube H belt buckle & Reversible… (2), Tete de Cheval belt buckle & Re… (2), Constance belt buckle & Reversi… (2) and 2 more; url: hermes.com.
curl 'https://api.crawlora.net/api/v1/hermes/suggest?locale=at_de' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | No | Partial search term; may be empty for Hermès' default suggestions | |
| 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",
"query": "bel",
"categories": [
{
"label": "Belts in Women collection",
"code": "WOMEN_BELTS",
"results": 293
},
{
"label": "Belts in Men collection",
"code": "MEN_BELTS",
"results": 193
}
],
"products": [
{
"label": "Tube H belt buckle & Reversible leather strap 38 mm",
"sku": "U_BELT_38_HOMME-H081675CP2K-H081779CAAA120",
"url": "https://www.hermes.com/us/en/product/tube-h-belt-buckle-reversible-leather-strap-38-mm-U_BELT_38_HOMME/",
"image": "https://assets.hermes.com/is/image/hermesproduct/081675CP_front_1"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.