HEMA
HEMA Store Stock API
In-store stock of up to 12 HEMA articles at the HEMA stores near a city, postcode or point, or across a country, in the Netherlands, Belgium, France, Germany, Luxembourg and Austria: per store the sellable units HEMA's store service reports, the stock level (full, regular or limited), shelf locations, address, distance, opening hours, holiday hours and services, plus how many of the stores hold each article. Costs 1 credit for up to 12 article numbers.
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/jsonskusstring[]required1 to 12 article numbers of one size and colour: items[].sku of a single article, or items[].online.variants[].sku / product variants[].sku for clothing (a colour group id such as 4230175BLACK is not a stock unit). Leading zeros are dropped.
Example: ["15300147", "10860090"]
countrystringdefault:nlThe HEMA market, as a lowercase country code. This endpoint serves every country with HEMA stores: nl, be, fr, de, lu (Luxembourg) and at (Austria). 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.lu— Luxembourg: 4 HEMA stores, no webshop.at— Austria: 5 HEMA stores, no webshop.
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
querystringA city, town or postcode, 1-100 characters (HEMA's own store finder places it), e.g. Utrecht, 3511, Antwerpen, Paris, Köln. Send query or lat + lng, not both; neither = stores across the country.
Example: Utrecht
latnumberOr latitude, -90 to 90 (with lng).
Example: 48.8566
lngnumberLongitude, -180 to 180 (with lat).
Example: 2.3522
radius_kmintegerdefault:50Search radius around the place in km, 1 to 300 (50 is what HEMA's site uses).
Example: 25
limitintegerdefault:10Stores to return, 1 to 50, nearest first.
Example: 20
in_stock_onlybooleandefault:falseOnly stores that hold at least one of the articles.
Example: true
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. Stock is what HEMA's store service reports for each store at the moment of the call: sellable units and a stock level, not a promise that the shelf has the item. Units change through the day; store every reading with fetched_at. HEMA's own note: online prices can differ from store prices. Near Utrecht on 2026-11-22 the cuddle cloth 15300147 showed 19 units (full) at Utrecht-Centrum, 1 (limited) at Hoog Catharijne and none listed at CS Utrecht: 9 of the 10 nearest stores held it. Cost: 1 credit for up to 12 article numbers (a city or postcode is placed first and still costs 1 credit).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=210)
# Units per store for two articles in the 10 HEMA stores nearest Utrecht.
d = client.hema.store_stock(skus=["15300147", "10860090"], query="Utrecht", country="nl")["data"]
print(d["summary"]) # stores holding each article
for s in d["stores"]:
units = {x["sku"]: (x["sellable_units"], x["stock_level"]) for x in s["stock"]}
print(s["store_id"], s["name"], s["distance_km"], "km", units)Response