Docs menu

Hermes API endpoint

Hermès search suggestions API

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.

GETapiKey2 credits/requestHermeshermes.suggestResponseDoc/hermes/suggest

Endpoint facts

Method: GET
API path: /hermes/suggest
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Hermes
Response schema: #/definitions/hermes.suggestResponseDoc

Hermès Scraper API Try Hermès search suggestions API in Playground Hermes API documentation

How this endpoint behaves

Query parameters:

query (optional) — partial search term, e.g. bel. May be empty, which returns Hermès' default suggestions rather than an error — the same thing its own search box shows before you type.
locale (optional) — market and language, default us_en. 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. Any other value returns 400 before any upstream request is made.

Notable response behavior:

categories[].code is the same category code hermes-category accepts, so a suggestion feeds straight into a category browse without a lookup.
categories[].results is how many items Hermès has behind that category for the term.
products[].sku can be passed to hermes-product. Note that belt and strap combinations carry a longer composite sku (U_BELT_38_HOMME-H081675CP2K-H081779CAAA120).
Either list may be empty for a term Hermès has no match for; that is a genuine empty result, not an error.

Live monitoring

Monitored request: GET /hermes/suggest?query=bel
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.74 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /hermes/suggest?query=bel
Items in products: 10
Fields filled in every checked item: 3

Field	Filled in, of 10 checked	Values in the sample
label	10	Tube H belt buckle & Reversible… (2), Tete de Cheval belt buckle & Re… (2), Constance belt buckle & Reversi… (2) and 2 more
sku	10
url	10	hermes.com

Request parameters

Parameter	Type	Required	Description	Example
query	string	No	Partial search term; may be empty for Hermès' default suggestions	bel
locale	string	No	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 Allowed values: 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.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/hermes/suggest?query=coffee&locale=at_de" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/hermes.suggestResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hermes.SuggestResponse	No
data.categories	array	No
data.categories[].code	string	No
data.categories[].label	string	No
data.categories[].results	integer	No
data.locale	string	No
data.products	array	No
data.products[].image	string	No
data.products[].label	string	No
data.products[].sku	string	No
data.products[].url	string	No
data.query	string	No
msg	string	No	ok

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/hermes/suggest?query=coffee&locale=at_de" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Hermes endpoint docs Hermès Scraper API Hermès categories API documentation Hermès category API documentation Hermès product API documentation Hermès product recommendations API documentation Hermès catalogue index API documentation Hermès search API documentation

Open in Playground Back to group

Docs menu

Hermes API endpoint

Hermès search suggestions API

GETapiKey2 credits/requestHermeshermes.suggestResponseDoc/hermes/suggest

Endpoint facts

Method: GET
API path: /hermes/suggest
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Hermes
Response schema: #/definitions/hermes.suggestResponseDoc

Hermès Scraper API Try Hermès search suggestions API in Playground Hermes API documentation

How this endpoint behaves

Query parameters:

query (optional) — partial search term, e.g. bel. May be empty, which returns Hermès' default suggestions rather than an error — the same thing its own search box shows before you type.
locale (optional) — market and language, default us_en. 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. Any other value returns 400 before any upstream request is made.

Notable response behavior:

categories[].code is the same category code hermes-category accepts, so a suggestion feeds straight into a category browse without a lookup.
categories[].results is how many items Hermès has behind that category for the term.
products[].sku can be passed to hermes-product. Note that belt and strap combinations carry a longer composite sku (U_BELT_38_HOMME-H081675CP2K-H081779CAAA120).
Either list may be empty for a term Hermès has no match for; that is a genuine empty result, not an error.

Live monitoring

Monitored request: GET /hermes/suggest?query=bel
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.74 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /hermes/suggest?query=bel
Items in products: 10
Fields filled in every checked item: 3

Field	Filled in, of 10 checked	Values in the sample
label	10	Tube H belt buckle & Reversible… (2), Tete de Cheval belt buckle & Re… (2), Constance belt buckle & Reversi… (2) and 2 more
sku	10
url	10	hermes.com

Request parameters

Parameter	Type	Required	Description	Example
query	string	No	Partial search term; may be empty for Hermès' default suggestions	bel
locale	string	No	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 Allowed values: 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.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/hermes/suggest?query=coffee&locale=at_de" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/hermes.suggestResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hermes.SuggestResponse	No
data.categories	array	No
data.categories[].code	string	No
data.categories[].label	string	No
data.categories[].results	integer	No
data.locale	string	No
data.products	array	No
data.products[].image	string	No
data.products[].label	string	No
data.products[].sku	string	No
data.products[].url	string	No
data.query	string	No
msg	string	No	ok

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/hermes/suggest?query=coffee&locale=at_de" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Hermès search suggestions API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Hermès search suggestions API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related