H&M API: prijzen, kleuren en maten van hm.com/nl als JSON

Deze API leest de Nederlandse webshop van H&M (www2.hm.com/nl_nl) zoals een klant hem ziet: naam, prijs in euro, de oorspronkelijke prijs zolang een artikel is afgeprijsd, elke kleur als apart artikel en per maat of die nog te bestellen is. Dit is geen officiële H&M-koppeling: leveranciers, merkpartners en affiliates die bestellingen of productfeeds met H&M willen uitwisselen, hebben hier niets aan. Er worden alleen openbare winkelgegevens gelezen, op het moment dat je de aanroep doet. De markt kies je met `country`. Laat je die weg, dan antwoordt de Amerikaanse winkel, met dollarprijzen en een ander assortiment.

Werkend voorbeeld

De kleurfilter werkt met de Nederlandse waarde uit `filters_available`: `zwart_000000` gaf 140 spijkerbroeken, het Engelse `black_000000` gaf 0 resultaten zonder foutmelding. Bovenaan staat een Bootcut Regular Jeans voor € 15,99 in plaats van € 29,99 (47% korting), maar alleen nog in maat 32 en 34; 8 van de 10 maten waren uitverkocht. Wie de goedkoopste broek zoekt, kijkt dus ook naar `sizes_in_stock`.

curl -X POST https://api.reefapi.com/hm/v1/search \
  -H "x-api-key: JOUW_API_SLEUTEL" \
  -H "content-type: application/json" \
  -d '{"query": "spijkerbroek dames", "country": "nl", "color": "zwart_000000", "sort": "price_asc", "page_size": 36}'

{
  "ok": true,
  "data": {
    "results": [
      {
        "article_code": "1316050003",
        "product_code": "1316050",
        "name": "Bootcut Regular Jeans",
        "brand": "H&M",
        "url": "https://www2.hm.com/nl_nl/productpage.1316050003.html",
        "price": 15.99,
        "regular_price": 29.99,
        "on_sale": true,
        "discount_percent": 47,
        "member_price": null,
        "price_formatted": "€ 15,99",
        "currency": "EUR",
        "color_name": "Zwart",
        "color_count": 4,
        "sizes": [
          { "size_code": "001", "label": "32", "in_stock": true },
          { "size_code": "002", "label": "34", "in_stock": true },
          { "size_code": "003", "label": "36", "in_stock": false },
          ...
        ],
        "sizes_in_stock": 2,
        "main_category": "ladies_jeans_bootcut",
        ...
      },
      {
        "article_code": "1239854001",
        "name": "Flared Low Jeans",
        "price": 15.99,
        "regular_price": 24.99,
        "on_sale": true,
        "discount_percent": 36,
        "color_name": "Zwart/washed out",
        "sizes_in_stock": 1,
        ...
      },
      ...
    ],
    "count": 36,
    "total_results": 140,
    "total_pages": 4,
    "has_more": true,
    "sort_applied": "price_asc",
    "filters_applied": { "color": "zwart_000000" },
    "locale": "nl_nl",
    "currency": "EUR"
  },
  "meta": { "record_count": 36, "charged_credits": 1, "cache_hit": false, "mode": "live" }
}

Grenzen en eerlijke kanttekeningen

• H&M heeft deze API niet gemaakt of goedgekeurd, en wij werken niet samen met H&M.
• `sale_only` werkt op hm.com/nl op dit moment niet. Op 26 oktober 2026 gaf `sale_only: true` drie keer 0 resultaten ('spijkerbroek dames', 'jas', en spijkerbroek dames in zwart), terwijl in dezelfde zwarte lijst 12 van de eerste 36 rijen een rode prijs hadden. H&M's eigen telling noemde alle 140 'niet in de uitverkoop'. Filter daarom zelf op `on_sale`. Zo'n lege aanroep slaagt technisch en kost dus 1 credit.
• Filterwaarden zijn per markt in de taal van die markt: kleuren als `zwart_000000` of `blauw_0000ff`, materialen als `Katoen`. Een Engelse waarde geeft geen fout, maar 0 resultaten. Haal de geldige waarden eerst uit `filters_available` van een gewone zoekopdracht.
• Productnamen zijn op hm.com/nl grotendeels Engels ('Wide High Waist Jeans', 'Bootcut Regular Jeans'), met hier en daar een Nederlandse ('Broek met barrel-pijpen'). Kleurnamen, omschrijving, kruimelpad en wasvoorschrift zijn wel Nederlands, en Nederlandse zoekwoorden werken: 'spijkerbroek dames' gaf 1.019 resultaten.
• `product/availability` geeft maatcodes ('002') zonder maatlabel; welke maat dat is (34, 36…) staat in `product/detail` onder `sizes`. Voor de Wide High Waist Jeans gaf availability 11 kleuren terug, terwijl product/detail er 37 noemt.
• Voorraad is ja of nee per maat, geen aantal, en voorraad per winkel publiceert H&M niet. Van de reviews krijg je alleen de (hooguit 10) reviews die op de productpagina staan (`reviews_sample`); de Wide High Waist Jeans had er 688.
• Land van productie (`country_of_production`) bleef leeg bij de Nederlandse jeans. In onze metingen publiceert H&M dat alleen op de Franse site.
• search, search/suggest en product/availability kosten 1 credit per aanroep, product/detail en category 2.