---
title: "Search the Hermès catalogue"
method: GET
path: "/hermes/search"
tags: ["Hermes"]
---

# Search the Hermès catalogue

`GET /hermes/search`

## Request

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

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.

## Query parameters

- `query` 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'
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HermesSearchResponseDoc
  - `code` integer
  - `data` HermesSearchResponse
    - `filters` HermesFilter[]
      - `attribute` string
      - `name` string
      - `values` HermesFilterValue[]
        - `count` integer
        - `name` string
        - `value` string
    - `locale` string
    - `page` integer
    - `page_size` integer
    - `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
    - `query` string
    - `results_for` string: ResultsFor is the term Hermès actually searched for, which can differ from query when it applies its own spelling correction. Empty when upstream reports no correction.
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/afac9b012a27?raw)