GET/hermes/categoriesapiKey3 credits/request
Returns every browsable Hermès category for a market: the category code hermes-category accepts, its display name, its page path and absolute URL, its parent code and its depth in the tree. This is the discovery endpoint for hermes-category's category parameter, so every accepted value is obtainable from this API rather than by reading the website. Editorial and story tiles that carry no browsable category page are excluded, so every code returned is one hermes-category will accept.
Optional: locale (37 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).
Sampled 14 Oct 2026: 175 items. Filled in every item: code, name, path, url, depth, children. Not in every item: parent_code (166). In the sample: depth: 0 to 2, median 2; name: “Women” and 129 other values; url: hermes.com; path: “/us/en/category/women/” and 174 other values; children: 0 to 18, median 0.
Open in Playground
GET/hermes/categoryapiKey5 credits/request
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.
Required: category. Optional: sort (3 allowed values: relevance, priceasc, pricedsc), locale (37 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), page.
Sampled 14 Oct 2026: 48 items. Filled in every item: sku, title, url, slug, price, currency, price_type, color and 11 more. In the sample: price: 1,125 to 1,900, median 1,275; title: “Jet sneaker” and 10 other values; url: hermes.com; colorless: true in 0 of 48; images: median 6 entries; color: “Blue” and 8 other values; more_colors: true in 0 of 48; size: 34 to 40.5, median 36.
Open in Playground
GET/hermes/productapiKey2 credits/request
Returns one Hermès product's full detail: title, description, dimensions, the Hermès colour name, country of manufacture, price with its market currency, stock, every product image, and the complete colour and size variant matrix with per-variant sku, price, stock and image. Care, gift and delivery text are returned as Hermès' own HTML fragments. sku accepts the reference-plus-colour form (H252013Z BM), the fuller listing sku that also carries size (H252013Z BM360), or the URL identifier returned by hermes-products (H252013ZvBM).
Required: sku. Optional: locale (37 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).
Sampled 14 Oct 2026: 21 items. Filled in every item: sku, title, color, price, url, image, in_stock. In the sample: price: 1,300 to 1,425, median 1,300; color: “blanc/noir” and 16 other values; url: hermes.com; in_stock: true in 21 of 21; image: assets.hermes.com.
Open in Playground
GET/hermes/product/recommendationsapiKey3 credits/request
Returns the cross-sell shelves Hermès shows on a product page: "keep exploring" (similar items) and "perfect partner" (items styled with it), each a list of products with price, stock and image. Takes the same sku forms as hermes-product. A product Hermès offers no recommendations for returns an empty shelves list rather than an error.
Required: sku. Optional: locale (37 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).
Sampled 14 Oct 2026: 2 items. Filled in every item: name, total, products. In the sample: name: “keep_exploring” and 1 other value; products: median 4 entries.
Open in Playground
GET/hermes/productsapiKey2 credits/request
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.
Optional: locale (37 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), page, limit, changed_since.
Sampled 14 Oct 2026: 40 items. Filled in every item: product_id, slug, url, last_modified. In the sample: last_modified: 2026-10-12; url: hermes.com.
Open in Playground
GET/hermes/searchapiKey5 credits/request
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.
Required: query. Optional: locale (37 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), page.
Sampled 14 Oct 2026: 48 items. Filled in every item: sku, title, url, slug, price, currency, price_type, color and 10 more. Not in every item: size (0). In the sample: price: 260 to 1,675, median 660; title: “Casaque Jumping scarf” and 38 other values; url: hermes.com; colorless: true in 0 of 48; images: median 3 entries; color: “Orange” and 11 other values; more_colors: true in 0 of 48; in_stock: true in 48 of 48.
Open in Playground
GET/hermes/storesapiKey3 credits/request
Returns Hermès' worldwide store directory: name, street address, city, postal code, country, geographic coordinates, phone, displayed opening hours, whether in-store appointments are offered, and store photos. Optionally narrowed to one country (by name or ISO-2 code) or city. Hermès publishes the same worldwide directory for every market, so locale selects the language names are returned in rather than which stores are listed.
Optional: locale (37 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), country, city.
Sampled 14 Oct 2026: 27 items. Filled in every item: id, name, street, city, postal_code, country, country_code, continent and 6 more. Not in every item: phone (25). In the sample: name: “Hermès Nice” and 26 other values; url: hermes.com; appointment_in_store: true in 0 of 27; opening_hours: median 70 characters; images: median 1 entry; city: “Nice” and 18 other values.
Open in Playground
GET/hermes/suggestapiKey2 credits/request
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.
Optional: query, locale (37 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).
Sampled 14 Oct 2026: 10 items. Filled in every item: label, sku, url. In the sample: label: Tube H belt buckle & Reversible… (2), Tete de Cheval belt buckle & Re… (2), Constance belt buckle & Reversi… (2) and 2 more; url: hermes.com.
Open in Playground