---
title: "Browse a Hermès category"
method: GET
path: "/hermes/category"
tags: ["Hermes"]
---

# Browse a Hermès category

`GET /hermes/category`

## Request

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

Browses one Hermès product category and returns a page of products (SKU, title, price with currency, colour, size, stock, images) plus the facet groups Hermès offers for that category, and the category's own title and description. The category parameter takes a category code from hermes-categories, which is the discovery endpoint for every accepted value. Page size is fixed at 48 by Hermès and cannot be changed. Prices are returned with the ISO-4217 currency for the selected market, since Hermès itself publishes bare numbers.

## Query parameters

- `category` string, required
- `sort` 'relevance' | 'priceasc' | 'pricedsc'
- `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

- HermesCategoryResponseDoc
  - `code` integer
  - `data` HermesCategoryResponse
    - `code` string
    - `description` string
    - `filters` HermesFilter[]
      - `attribute` string
      - `name` string
      - `values` HermesFilterValue[]
        - `count` integer
        - `name` string
        - `value` string
    - `locale` string
    - `name` string
    - `page` integer
    - `page_size` integer
    - `path` string
    - `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
    - `sort` string
    - `title` string
    - `total` integer
    - `url` string
  - `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/0497899e2016?raw)