HEMA
HEMA Offers API
HEMA's weekly offers page in the Netherlands and Belgium: HEMA's validity label as shown (geldig t/m 22 november = valid until 22 November), the same date as an ISO valid_to, HEMA's offer week number, and every promotion card by department with the category path that lists its products. The page carries the promotions, not the products: pass a card's category to /api/v1/hema/category for the products with their prices and promotion texts. Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncountrystringdefault:nlThe HEMA market, as a lowercase country code. This endpoint serves nl and be (nl-be or fr-be): the two markets with HEMA's weekly offers page. fr, de, lu and at answer 400, not charged. Prices are in EUR everywhere. Any other country answers 400, not charged.
Example: nl
nl— Netherlands, nl (Dutch) (nl-nl, www.hema.nl), 570 stores. The default.be— Belgium, nl (Dutch) or fr (French); default nl (nl-be, www.hema.com/nl-be; fr-be, www.hema.com/fr-be), 111 stores.
languagestringBelgium only: nl (default, nl-be) or fr (fr-be). The other countries have one language: leave language out (sending another answers 400, not charged). Names, labels and facet values come back in it; prices are the same on both Belgian webshops.
Example: fr
Notes
Store. HEMA, the Dutch variety store (hema.nl / hema.com), on its four webshops: country picks the market (default nl, www.hema.nl; be, fr and de on www.hema.com) and, in Belgium, language the webshop (nl-be or fr-be). Names, labels, promotion texts, category names and facet values come back in that webshop's language, as HEMA writes them (Dutch by default); field names are English. Prices are numbers in EUR on every market. An article number (sku) is the same in every market; HEMA sets the price per market. Luxembourg (lu) and Austria (at) have HEMA stores but no webshop: only stores, store and store-stock serve them. Every webshop answer echoes country, language, market (e.g. nl-nl) and currency. Not the HEMA monomer or Hema Pharmaceuticals. On Sunday 2026-11-22 the Dutch page read geldig t/m 22 november (week 47) with 74 promotion cards in 12 sections, 37 of them Black Friday lists (black-friday-sokken, black-friday-kerstballen ...). The label has no year: Scavio takes the nearest one. Cost: 1 credit.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# This week's HEMA offers in the Netherlands, then the products of the first card.
o = client.hema.offers(country="nl")["data"]
print(o["label"], o["valid_to"], "week", o["week"], o["count"], "cards")
card = next(c for s in o["sections"] for c in s["cards"] if c["category"])
items = client.hema.category(category=card["category"], country="nl")["data"]["items"]
for i in items[:5]:
print(card["title"], i["sku"], i["name"], i["price"], i["promotion"])Response