HEMA
HEMA Search API
Search HEMA, the Dutch variety store, on any of its four webshops (nl, be in Dutch or French, fr, de): 24 products a page with the article number, price, HEMA's struck-through price, from-price flag, promotion text (2+2 gratis, 2e halve prijs), sizes, online stock per variant and rating, plus facets to filter by and five sorts. The market's language works best (sokken, kaars, bougie, Kerze). A word HEMA sends to a category or campaign page (kerst) comes back as that page, named in redirected_to. A search with no match answers 200 with total 0. 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/jsonquerystringrequiredSearch text, 1-200 characters. The market's language works best: sokken (socks, nl), kaars (candle, nl), bougie (fr), Kerze (de). Some words land on a category or campaign page (kerst = Christmas): redirected_to names it.
Example: sokken
countrystringdefault:nlThe HEMA market, as a lowercase country code. This endpoint serves the four webshops: nl (nl-nl), be (nl-be, or fr-be with language fr), fr (fr-fr) and de (de-de). lu and at have no webshop and 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.fr— France, fr (French) (fr-fr, www.hema.com/fr-fr), 69 stores.de— Germany, de (German) (de-de, www.hema.com/de-de), 17 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
sortenum<string>default:relevanceResult order, as HEMA sorts. A tile with a from-price (price_from true) is placed by one of its variants' prices, so a price sort is not always strictly ordered by the price shown.
Example: price_asc
relevance— HEMA's own order (default).price_asc— Price low to high.price_desc— Price high to low.newest— Newest first.best_selling— HEMA's best-selling (popular) order.
pageintegerdefault:1Page, 1 to 100, 24 products a page; total_pages says how deep the list goes.
Example: 2
filtersobjectUp to 6 facets: { "<facets[].facet>": "<facets[].values[].value>" } or a list of up to 10 values per facet (e.g. size, maincolour, producttype, searchable for online stock). Values in the market's language, as facets lists them.
Example: {"maincolour": "zwart"}
new_onlybooleanOnly HEMA's new collection.
Example: true
price_minnumberLowest price, EUR (0 to 10,000).
Example: 5
price_maxnumberHighest price, EUR (0 to 10,000); not below price_min.
Example: 15
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. Cost: 1 credit (a search HEMA redirects to a category, read with a sort, page or filter, still costs 1 credit).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Candles in three HEMA markets: article numbers match across them, prices are set per market.
for country, language, query in [("nl", None, "kaars"), ("be", "fr", "bougie"), ("de", None, "Kerze")]:
data = client.hema.search(query=query, country=country, language=language)["data"]
print(data["market"], data["total"], "results")
for i in data["items"][:5]:
print(" ", i["sku"], i["name"], i["price"], i["was_price"], i["promotion"])Response