---
title: "List the Hermès catalogue index"
method: GET
path: "/hermes/products"
tags: ["Hermes"]
---

# List the Hermès catalogue index

`GET /hermes/products`

## Request

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

Returns a page of Hermès' full catalogue index for one market: each product's URL, slug, URL identifier and the date Hermès last modified it. Built from Hermès' own product sitemap, so it enumerates the entire catalogue for that market including items no category listing surfaces. Use changed_since to return only products added or updated on or after a date, which makes this a new-arrivals feed. The product_id is the identifier used in the product URL and is NOT the same string as the sku returned by hermes-category and hermes-search, which also encodes size.

## Query parameters

- `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
- `limit` integer
- `changed_since` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HermesProductsResponseDoc
  - `code` integer
  - `data` HermesProductsResponse
    - `limit` integer
    - `locale` string
    - `page` integer
    - `products` HermesCatalogueProduct[]
      - `last_modified` string
      - `product_id` string: ProductID is the identifier Hermès uses in the product URL. It is NOT the same string as the sku returned by hermes-category/hermes-search -- see the type doc on ProductsResponse.
      - `slug` string
      - `url` string
    - `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)