To get HEMA store stock, call Scavio's HEMA API: POST /api/v1/hema/store-stock with up to 12 article numbers and a city, postcode or point returns, for each HEMA store nearby, the sellable units HEMA's store service reports and a stock level (full, regular or limited), 1 credit a call. POST /api/v1/hema/product returns one article's price, its promotion with valid_from and valid_to, and the promotions HEMA has already scheduled; send country be, fr or de for the same article on another webshop.
HEMA is the Dutch variety store, not the HEMA monomer or Hema Pharmaceuticals. It sells online on four webshops, hema.nl and hema.com for Belgium (in Dutch and French), France and Germany, and has stores in those countries plus Luxembourg and Austria: 570, 111, 69, 17, 4 and 5 on November 22, 2026. One article number is the same on every webshop; the price is set per webshop. HEMA has no public developer API for any of it.
Every response below is a trimmed capture from Scavio's HEMA API on Sunday, November 22, 2026, between 10:15 and 11:03 UTC. Image links are cut from every sample. Prices are numbers in EUR; names and labels stay in the webshop's language as HEMA writes them, Dutch by default.
Step 1: Find the article number
Search returns 24 products a page, with five sorts and facets:
curl -s https://api.scavio.dev/api/v1/hema/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "chocoladeletter"}'{
"data": {
"country": "nl",
"market": "nl-nl",
"currency": "EUR",
"query": "chocoladeletter",
"redirected_to": null,
"list_type": "grid",
"sort": "relevance",
"page": 1,
"page_size": 24,
"total": 134,
"total_pages": 6,
"has_more": true,
"count": 24,
"items": [
{
"sku": "24427419S",
"name": "handgedecoreerde chocoladeletter melk S 180g",
"price": 5.49,
"was_price": null,
"price_from": false,
"currency": "EUR",
"promotion": "2e halve prijs",
"product_type": "chocoladeletter",
"sizes": ["melk"],
"stock_status": "IN_STOCK",
"online": {"available": true, "limited_stock": null, "variants": [{"sku": "24427419", "available": true, "limited_stock": true}]}
}
]
},
"credits_used": 1
}Trimmed to 1 of 24 items. sku 24427419S is the tile's group id; the article number of one size and colour is in online.variants[].sku, here 24427419. Store stock takes that one. Send sort (price_asc, price_desc, newest, best_selling) or a value from facets in filters to narrow the list. Search in the webshop's language: chocoladeletter on hema.nl, bougie on the French webshop.
Step 2: Read the article, its promotion and the next ones
Product takes an article number or a HEMA link, 1 credit:
curl -s https://api.scavio.dev/api/v1/hema/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sku": "24427419"}'{
"data": {
"market": "nl-nl",
"currency": "EUR",
"sku": "24427419",
"ean": "8721245105771",
"name": "handgedecoreerde chocoladeletter melk S 180g",
"status": "ACTIVE",
"price": 5.49,
"was_price": null,
"unit_price": {"price": 30.5, "unit": "kg"},
"promotion": {"label": "2e halve prijs", "loyalty_card_only": false, "valid_from": "2026-11-16", "valid_to": "2026-11-29"},
"price_schedule": [
{"valid_from": "2026-11-16", "valid_to": "2026-11-29", "price": 5.49, "was_price": null, "promotion": "2e halve prijs", "loyalty_card_only": false},
{"valid_from": "2026-11-29", "valid_to": "2026-12-06", "price": 5.49, "was_price": null, "promotion": null, "loyalty_card_only": false},
{"valid_from": "2026-12-06", "valid_to": "2026-12-20", "price": 5.49, "was_price": null, "promotion": "1+1 gratis", "loyalty_card_only": false},
{"valid_from": "2026-12-20", "valid_to": null, "price": 5.49, "was_price": null, "promotion": null, "loyalty_card_only": false}
],
"online_stock": {"type": "LIMITED", "units": 5766},
"sellable_in_store": true,
"order_limit": {"min": 1, "max": 200, "step": 1}
},
"credits_used": 1
}Trimmed to some fields; the answer also carries images, breadcrumbs, specifications, nutrition, variants and the unit_price of each schedule entry.
- The promotion: "2e halve prijs" (the second at half price) from November 16 to November 29, HEMA's Black Friday window.
- What comes next:
price_scheduleis HEMA's own dated list, so the "1+1 gratis" from December 6 to December 20 was already there on November 22.valid_tonull means open-ended. Consecutive entries share their boundary date, so read the dates as HEMA's and do not count days from them. - Online and store:
online_stock.unitsis the webshop's stock;sellable_in_storesays whether stores sell it. Stores have their own counts (step 3).
Step 3: Read units per store near a city
Store stock takes up to 12 article numbers and a city, postcode or lat and lng. Here are the Sint countdown calendar, the wooden Christmas countdown calendar and the chocolate letter near Utrecht:
curl -s https://api.scavio.dev/api/v1/hema/store-stock \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"skus": ["25900177", "41501061", "24427419"], "query": "Utrecht", "limit": 10}'{
"data": {
"country": "nl",
"skus": ["25900177", "41501061", "24427419"],
"location": {"query": "Utrecht", "formatted_address": "Utrecht, Nederland", "postcode": "3511", "city": "Utrecht", "country_code": "NL", "latitude": 52.08979, "longitude": 5.11414},
"radius_km": 50,
"limit": 10,
"in_stock_only": false,
"count": 10,
"summary": [{"sku": "25900177", "stores_with_stock": 4}, {"sku": "41501061", "stores_with_stock": 1}, {"sku": "24427419", "stores_with_stock": 7}],
"stores": [
{
"store_id": "0266",
"name": "Utrecht-Kanaleneiland",
"operator": "hema",
"address": {"street": "Hammerskjöldhof 32", "postcode": "3527 HE", "city": "Utrecht", "country_code": "NL"},
"distance_km": 1.99,
"special_hours": [{"date": "2026-11-29", "type": "KOOPZONDAG", "open": "11:00", "close": "18:00"}, {"date": "2026-12-24", "type": "GEWIJZIGD", "open": "09:00", "close": "18:00"}],
"closed_dates": ["2026-12-25", "2026-12-26", "2027-01-01"],
"stock": [
{"sku": "25900177", "sellable_units": 2, "stock_level": "limited", "stock_indicator": "LimitedStock", "shelf_locations": ["HSZ-B02-4-3-1"], "in_stock": true},
{"sku": "41501061", "sellable_units": null, "stock_level": null, "stock_indicator": null, "shelf_locations": [], "in_stock": false},
{"sku": "24427419", "sellable_units": 13, "stock_level": "full", "stock_indicator": "FullStock", "shelf_locations": [], "in_stock": true}
]
},
{
"store_id": "0054",
"name": "Utrecht-Overvecht",
"distance_km": 2.74,
"stock": [
{"sku": "25900177", "sellable_units": 4, "stock_level": "regular", "stock_indicator": "RegularStock", "shelf_locations": ["LSE-A10-4-3-1"], "in_stock": true},
{"sku": "41501061", "sellable_units": 1, "stock_level": "limited", "stock_indicator": "LimitedStock", "shelf_locations": ["LSE-TB1-2-2-1"], "in_stock": true},
{"sku": "24427419", "sellable_units": null, "stock_level": null, "stock_indicator": null, "shelf_locations": [], "in_stock": false}
]
}
]
},
"credits_used": 1
}Trimmed to 2 of 10 stores, 2 of 7 dated special hours and some store fields (each store also carries hours, phone and services). Captured at 11:02 UTC.
- Units and level:
sellable_unitsis what HEMA's store service reports for that store;stock_levelis HEMA's full, regular or limited. In our 10:19 UTC capture of every Dutch and Belgian store, limited always meant 1 or 2 units, regular 3 or 4, full 5 or more. A store with no units hasstock_levelnull (one row in that capture carried 0 units, a null level andstock_indicator"NoStock"). - Reach: stores come nearest first, within
radius_km(default 50, up to 300), up tolimit50. Sendin_stock_only: trueto drop stores with none. A place HEMA cannot find is a 404, charged 1 credit. - Country:
countrydefaults to nl; send be, fr, de, lu or at for stores there. Luxembourg and Austria have stores but no webshop.
To cover a whole country, split it into circles that each hold fewer than 50 stores: every Dutch and Belgian store took 26 calls in our store stock comparison.
Step 4: List the stores
Stores without a place returns every store of a country; with a city or postcode, the nearest:
curl -s https://api.scavio.dev/api/v1/hema/stores \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "be", "query": "Antwerpen", "limit": 5}'{
"data": {
"country": "be",
"location": {"query": "Antwerpen", "formatted_address": "Antwerpen, Vlaanderen, België", "postcode": "2000", "city": "Antwerpen", "country_code": "BE", "latitude": 51.22212, "longitude": 4.39769},
"radius_km": 50,
"limit": 5,
"count": 5,
"stores": [
{
"store_id": "0406",
"name": "Antwerpen-Meir",
"status": "open",
"operator": "hema",
"address": {"street": "Meir 65", "postcode": "2000", "city": "Antwerpen", "country_code": "BE"},
"distance_km": 0.82,
"hours": [{"day": "friday", "open": "09:00", "close": "19:00"}, {"day": "saturday", "open": "09:00", "close": "19:00"}, {"day": "sunday", "open": "09:30", "close": "18:00"}],
"closed_dates": ["2026-12-25", "2027-01-01"],
"services": ["Raamdecoratieservice", "FotoExpressOnline", "PickupFromStore", "PickInStore", "Zelfscan"]
}
]
},
"credits_used": 1
}Trimmed to 1 of 5 stores, 3 of 7 days and some services. {"country": "nl"} with no place returned all 570 Dutch stores in one call; operator says whether HEMA or a franchisee runs the store.
Step 5: Check one store for one article
Store takes a store_id and, optionally, one article number:
curl -s https://api.scavio.dev/api/v1/hema/store \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store_id": "0013", "sku": "25900177"}'{
"data": {
"store_id": "0013",
"name": "Utrecht-Centrum",
"status": "open",
"address": {"street": "Steenweg 59", "postcode": "3511 JN", "city": "Utrecht", "country_code": "NL"},
"delivery_address": {"street": "Steenweg 61", "postcode": "3511 JN", "city": "Utrecht", "country_code": "NL"},
"country": "nl",
"sku": "25900177",
"stock": {"sku": "25900177", "sellable_units": null, "stock_level": null, "stock_indicator": null, "shelf_locations": [], "in_stock": false}
},
"credits_used": 1
}Trimmed to some fields. The Sint countdown calendar had no units in this store at 11:02 UTC. An unknown store id is a 404, charged 1 credit.
Step 6: Read this week's offers
Offers reads HEMA's weekly offers page in the Netherlands or Belgium:
curl -s https://api.scavio.dev/api/v1/hema/offers \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl"}'{
"data": {
"market": "nl-nl",
"path": "aanbiedingen",
"label": "geldig t/m 22 november",
"valid_to": "2026-11-22",
"week": 47,
"section_count": 12,
"count": 74,
"sections": [
{
"name": "kerst",
"week": 47,
"cards": [
{"title": "losse kerstballen en -sets", "subtitle": null, "url": "https://www.hema.nl/kerst/aanbiedingen/black-friday-kerstballen", "category": "kerst/aanbiedingen/black-friday-kerstballen"},
{"title": "kunstkerstbomen", "subtitle": null, "url": "https://www.hema.nl/kerst/aanbiedingen/black-friday-kunstkerstbomen", "category": "kerst/aanbiedingen/black-friday-kunstkerstbomen"}
]
}
]
},
"credits_used": 1
}Trimmed to 1 of 12 sections. label is HEMA's text ("valid until 22 November") and valid_to its ISO date. HEMA's offer week runs Monday to Sunday, so week 48 starts on Monday, November 23. The page lists promotion cards, not products: send a card's category to category for its products, 1 credit (kerst/aanbiedingen/black-friday-kerstballen held 115 baubles and sets on "2+1 gratis").
Step 7: Read the Sinterklaas and Christmas pages
Campaign reads sinterklaas (Netherlands and Belgium) or christmas (every webshop):
curl -s https://api.scavio.dev/api/v1/hema/campaign \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign": "sinterklaas"}'{
"data": {
"market": "nl-nl",
"campaign": "sinterklaas",
"slug": "sinterklaas",
"list_type": "landing",
"title": "Sinterklaasspullen kopen? Shop nu online",
"total": 13,
"count": 13,
"carousels": [{"title": "speelgoed favorieten van Sinterklaas", "link": "https://www.hema.nl/sint-folder", "count": 2, "skus": ["15100411", "15100374"]}],
"items": [
{
"sku": "15100411",
"name": "activiteitentafel 52.5x49.2cm hout boerderij",
"price": 39.99,
"was_price": null,
"promotion": "2+1 gratis",
"labels": ["nieuw"],
"online": {"available": true, "limited_stock": true, "variants": []}
}
]
},
"credits_used": 1
}Trimmed to 1 of 13 items. On November 22 the Christmas page held 39 products on hema.nl, 37 on the Belgian webshop, 54 in France and 26 in Germany.
Step 8: Compare one article across webshops, and what each promotion takes off
Send the same article number with country be, fr or de. The baby wipes (11700031) on hema.nl and on the Belgian webshop:
curl -s https://api.scavio.dev/api/v1/hema/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sku": "11700031", "country": "be"}'{
"data": {
"market": "nl-be",
"sku": "11700031",
"name": "Takkie en Siepie baby hand- en gezichtsdoekjes aloë vera - 40 stuks",
"price": 1.69,
"promotion": {"label": "2+1 gratis ; met HEMA extra", "loyalty_card_only": true, "valid_from": "2026-11-16", "valid_to": "2027-01-31"}
},
"credits_used": 1
}On hema.nl the same article was €1.49 with "2+1 gratis ; met je HEMA pas"; both are loyalty-card promotions (loyalty_card_only true). Other pairs from November 22, quoted as HEMA writes them:
- Chocolate bomb (24562508): "2 voor 5.49" at €3.19 on hema.nl, "2 voor 5.99" at €3.39 on the Belgian webshop.
- Sheet mask (17860191): "1+1 gratis" at €3.49 on hema.nl, "-80% ; sur le 2ème" at €2.99 in France.
- Chocolate letters: "1+1 gratis" scheduled from December 6 to December 20 on hema.nl and from December 6 to January 3 in Belgium.
What a multi-buy takes off per unit when you buy the full set, at the prices above:
| HEMA's label | You pay for | Off per unit |
|---|---|---|
| 1+1 gratis | 1 of 2 | 50% |
| 2+1 gratis | 2 of 3 | 33.3% |
| 2e halve prijs | 1.5 of 2 | 25% |
| -80% ; sur le 2ème | 1.2 of 2 | 40% |
| 3 voor 9.99 (coffee cups at €5.49) | €9.99 for €16.47 | 39.3% |
| 2 voor 5.49 (chocolate bomb at €3.19) | €5.49 for €6.38 | 14.0% |
| 2 voor 5.99 (same, Belgium, €3.39) | €5.99 for €6.78 | 11.7% |
Arithmetic on HEMA's labels and prices; buying fewer than the set gives no discount. Is HEMA more expensive in Belgium? compares 118 articles this way.
Step 9: Read reviews
Reviews returns HEMA's own product reviews, 8 on page 1 and 30 more per page up to page 5:
curl -s https://api.scavio.dev/api/v1/hema/reviews \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sku": "24427419"}'{
"data": {
"market": "nl-nl",
"sku": "24427419",
"review_pool": "nl-nl",
"sort": "newest",
"page": 1,
"page_size": 8,
"total_text_reviews": 13,
"average_rating": 4.47,
"total_ratings": 70,
"ratings_only": 57,
"recommended": 12,
"not_recommended": 1,
"rating_distribution": {"1": 3, "2": 1, "3": 2, "4": 18, "5": 46},
"reviews": [
{"review_id": "1237529062", "language": "nl_NL", "rating": 5, "title": "De beste", "text": "Lekkerste chocolade letter verkrijgbaar in Nederland", "submitted_at": "2026-11-20T09:28:58.000+00:00", "recommends": true, "verified_purchaser": false}
]
},
"credits_used": 1
}Trimmed to 1 of 8 reviews. 70 star ratings, 13 of them with text. No reviewer name or identity is returned. The French and German webshops read the Dutch review pool; the Belgian webshop has its own review_pool (nl-be), but for this article its first page held the same 8 reviews as the Dutch one. Reviews take 15 to 70 seconds a call.
Step 10: Poll store stock through Black Friday and Sinterklaas
HEMA's Black Friday runs to Sunday, November 29, and Sinterklaas is Saturday, December 5. Scavio keeps no cache and no history, so a record of store stock is the readings you store. This script reads the stores near a few cities for your articles, appends one row per store and article to a CSV, and sums credits_used:
import csv, datetime, json, os, urllib.request
KEY = os.environ["SCAVIO_API_KEY"]
URL = "https://api.scavio.dev/api/v1/hema/store-stock"
SKUS = ["25900177", "41501061", "24427419", "15100374"]
PLACES = [("nl", "Amsterdam"), ("nl", "Rotterdam"), ("nl", "Utrecht"), ("be", "Antwerpen"), ("be", "Gent")]
def call(body):
req = urllib.request.Request(URL, data=json.dumps(body).encode(), method="POST",
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
with urllib.request.urlopen(req, timeout=120) as r:
return json.load(r)
now = datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="seconds")
credits = 0
with open("hema-store-stock.csv", "a", newline="") as f:
out = csv.writer(f)
for country, place in PLACES:
res = call({"skus": SKUS, "country": country, "query": place, "radius_km": 15, "limit": 50})
credits += res["credits_used"]
for s in res["data"]["stores"]:
for x in s["stock"]:
out.writerow([now, country, place, s["store_id"], s["name"], x["sku"], x["sellable_units"], x["stock_level"]])
print(f"{now}: {credits} credits")Five places are 5 credits a run, $0.005 at the Growth rate of $1 per 1,000 credits. Three runs a day from Monday, November 23 to Saturday, December 5 (13 days) are 195 credits. Every Dutch and Belgian store for up to 12 articles is 26 credits a run.
All 13 endpoints and their credits
| Endpoint | What it returns | Credits |
|---|---|---|
| store-stock | Units and stock level for up to 12 articles at the stores near a place | 1 |
| stores | Every store of a country, or the nearest to a place | 1 |
| store | One store, optionally with one article's units | 1 |
| product | One article with promotion dates and price schedule | 1 |
| search | Products for a keyword, 24 a page | 1 |
| category | One category's products | 1 |
| categories | The category menu, 3 levels | 1 |
| new-arrivals | HEMA's new collection | 1 |
| sale | The sale page (nl) or outlet (be, de) | 1 |
| offers | The weekly offers page (nl, be) with its validity | 1 |
| campaign | The Christmas or Sinterklaas page | 1 |
| suggestions | Search suggestions and up to 5 products | 1 |
| reviews | HEMA's product reviews, no reviewer names | 1 |
Every call reports credits_used. A request refused before the call and a failed upstream call are not charged; a not-found is.
What the API does not return: price or stock history, brands (HEMA sells its own), checkout, the photo service, cake orders, loyalty balances, and countries HEMA left (the UK, Spain). France has no offers or sale page, and Germany no offers page.
Getting started
- Sign up and copy your API key: 50 free credits, no card.
- Run a store-stock call in the playground.
- Save the article numbers you watch from search or the Sinterklaas and Christmas pages.
- Run the poll script from Monday, November 23 through Saturday, December 5.
- Price the same articles on the Belgian, French and German webshops with
productandcountry.
Try the HEMA API free, 50 credits, no card.
Reference: HEMA API · store-stock docs · product docs · offers docs · best HEMA store stock APIs · is HEMA more expensive in Belgium? · how to get Argos store stock and prices
Frequently asked questions
Does HEMA have a public API?
No. HEMA publishes no public product, price, promotion or stock API; suppliers use a supplier portal and approved affiliates get a product feed for their own links. Scavio's HEMA API returns HEMA's public product, list, offer, store, stock and review pages as JSON, 1 credit a call.
How do I see until when a HEMA offer is valid?
The product answer carries it. Each article's promotion has valid_from and valid_to as ISO dates, and its price_schedule lists the next promotions HEMA has already dated: on November 22, 2026, chocolate letters on '2e halve prijs' until November 29 were scheduled for '1+1 gratis' from December 6 to December 20 in the Netherlands. The weekly offers page gives its own validity label, such as 'geldig t/m 22 november'.
Can I check HEMA stock in a store online?
Yes. HEMA's product pages show stock at nearby stores, one product at a time. By API, POST /api/v1/hema/store-stock with up to 12 article numbers and a city or postcode returns the sellable units HEMA's store service reports at each store nearby, with a stock level, up to 50 stores per call. Units change during the day.
Are HEMA prices the same in the Netherlands and Belgium?
Mostly not, in our sample. On November 22, 2026, 107 of 118 articles from five hema.nl departments cost more on HEMA's Belgian webshop, 11 cost the same and none cost less; the median over all 118 was 8.3% higher. Online prices can differ from store prices, as HEMA notes.
What do HEMA's terms say?
Scavio does not collect or store HEMA data: each call fetches the public HEMA page at the moment your request asks for it and returns what it shows as JSON, with no response cache. HEMA's website disclaimer and terms cover how its site and content may be used; read the current terms for your use case and get your own advice. This is not legal advice.