Endpoint Playground

Try the Hermès search API

Searches the Hermès catalogue by keyword and returns a page of products in the same shape as hermes-category. A query Hermès has no match for returns total 0 with an empty products array: Hermès itself renders unrelated fallback recommendations on a no-results page, and those are deliberately not returned as results. When Hermès applies its own spelling correction the corrected term is reported in results_for. Page size is fixed at 48 by Hermès and cannot be changed.

What a live request returned

14 Oct 2026: 48 products; 18 fields had a value in every checked item; 1 field was empty in this sample.

Observed request: GET /hermes/search?query=scarf
Fields with a value in every checked item: sku, title, url, slug, price, currency, price_type, color

Sample value profiles: price: 260 to 1,675, median 660; title: “Casaque Jumping scarf” and 38 other values; url: hermes.com.

Request: GET /hermes/search
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.9%, median 14.78 s
Monitored request: GET /hermes/search?query=scarf

Hermès search API documentation Hermès platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/hermes/search?query=scarf&locale=at_de' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	scarf	Search keyword
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
page	integer	No		One-based result page; page size is fixed at 48. Page 1 is fully validated; pages beyond 1 are best-effort and provisional

Example JSON response

{
  "code": 200,
  "msg": "ok",
  "data": {
    "locale": "us_en",
    "query": "scarf",
    "total": 1078,
    "page": 1,
    "page_size": 48,
    "products": [
      {
        "sku": "H004368S 04",
        "title": "La Nature en Voyage scarf 90",
        "url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/",
        "slug": "la-nature-en-voyage-scarf-90",
        "price": 505,
        "currency": "USD",
        "price_type": "fixed",
        "color": "Blue",
        "colorless": false,
        "more_colors": true,
        "size": "",
        "product_code": "S1A1",
        "department_code": "S",
        "family_code": "S01",
        "division_code": "01",
        "in_stock": true,
        "in_store": false,
        "personalizable": false,
        "images": [
          "https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1"
        ]
      }
    ],
    "filters": []
  }
}

More Hermes endpoints

List Hermès category codes Browse a Hermès category Get a Hermès product Get a Hermès product's recommended items List the Hermès catalogue index List Hermès stores Hermès search suggestions

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey5 credits/requesthermes.searchResponseDocHermes

GET /hermes/search

Search the Hermès catalogue

Response behavior

- **A query with no matches returns `total` 0 and an empty `products` array.** Hermès' own no-results page still renders around 18 unrelated recommendations; those are deliberately not returned, so an empty result is never disguised as a list of unrelated products. - `results_for` appears only when Hermès applied its own spelling correction and searched for a different term than the one supplied. - **Page 1 is fully validated; pages beyond 1 are best-effort and should be treated as provisional.** When a page beyond 1 cannot be fetched the endpoint returns an upstream error rather than silently returning page 1 again. - **Page size is fixed at 48 by Hermès and cannot be changed.** `page_size` always reports 48; a page past the end returns an empty `products` array with the real `total` still reported. - `price` is a bare number as Hermès publishes it; `currency` is the ISO-4217 code for the selected market. - `filters` are the facet groups Hermès offers for the query, and are informational — this endpoint does not currently accept facet filters as inputs. A no-results query returns no facet groups.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Search keyword

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "ok",
  "data": {
    "locale": "us_en",
    "query": "scarf",
    "total": 1078,
    "page": 1,
    "page_size": 48,
    "products": [
      {
        "sku": "H004368S 04",
        "title": "La Nature en Voyage scarf 90",
        "url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/",
        "slug": "la-nature-en-voyage-scarf-90",
        "price": 505,
        "currency": "USD",
        "price_type": "fixed",
        "color": "Blue",
        "colorless": false,
        "more_colors": true,
        "size": "",
        "product_code": "S1A1",
        "department_code": "S",
        "family_code": "S01",
        "division_code": "01",
        "in_stock": true,
        "in_store": false,
        "personalizable": false,
        "images": [
          "https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1"
        ]
      }
    ],
    "filters": []
  }
}

Try the Hermès search API

What a live request returned

14 Oct 2026: 48 products; 18 fields had a value in every checked item; 1 field was empty in this sample.

Observed request: GET /hermes/search?query=scarf
Fields with a value in every checked item: sku, title, url, slug, price, currency, price_type, color

Sample value profiles: price: 260 to 1,675, median 660; title: “Casaque Jumping scarf” and 38 other values; url: hermes.com.

Request: GET /hermes/search
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.9%, median 14.78 s
Monitored request: GET /hermes/search?query=scarf

Hermès search API documentation Hermès platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/hermes/search?query=scarf&locale=at_de' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	scarf	Search keyword
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
page	integer	No		One-based result page; page size is fixed at 48. Page 1 is fully validated; pages beyond 1 are best-effort and provisional

Example JSON response

{
  "code": 200,
  "msg": "ok",
  "data": {
    "locale": "us_en",
    "query": "scarf",
    "total": 1078,
    "page": 1,
    "page_size": 48,
    "products": [
      {
        "sku": "H004368S 04",
        "title": "La Nature en Voyage scarf 90",
        "url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/",
        "slug": "la-nature-en-voyage-scarf-90",
        "price": 505,
        "currency": "USD",
        "price_type": "fixed",
        "color": "Blue",
        "colorless": false,
        "more_colors": true,
        "size": "",
        "product_code": "S1A1",
        "department_code": "S",
        "family_code": "S01",
        "division_code": "01",
        "in_stock": true,
        "in_store": false,
        "personalizable": false,
        "images": [
          "https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1"
        ]
      }
    ],
    "filters": []
  }
}

Search the Hermès catalogue

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "ok", "data": { "locale": "us_en", "query": "scarf", "total": 1078, "page": 1, "page_size": 48, "products": [ { "sku": "H004368S 04", "title": "La Nature en Voyage scarf 90", "url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/", "slug": "la-nature-en-voyage-scarf-90", "price": 505, "currency": "USD", "price_type": "fixed", "color": "Blue", "colorless": false, "more_colors": true, "size": "", "product_code": "S1A1", "department_code": "S", "family_code": "S01", "division_code": "01", "in_stock": true, "in_store": false, "personalizable": false, "images": [ "https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1" ] } ], "filters": [] } }