Skip to content

Products

A product has three identifiers. All three are accepted as {id} in /v1/Products/{id} and its sub-resources.

Field Example Use it for
id 5d0c8a3e-… (GUID) Storing. Stable; use this as your key.
kieskeurigId 1234567 Matching with kieskeurig.nl. Not every product has one.
uid legacy string Backwards compatibility only.

EANs are not identifiers of a product but aliases: one product can have several EANs (colour or pack variants, regional barcodes), listed in aliases. Search by EAN with GET /v1/Products?Ean=….

GET /v1/Products combines all parameters you pass:

Parameter Matches
Query Free-text search
Ean Products with this EAN as an alias (digits only, max 13)
KieskeurigId Up to 50 Kieskeurig ids
Brands Up to 10 brand names
ProductCodes Up to 10 manufacturer product codes
Shops Products with an offer at one of up to 10 shop ids
CategoryTreeNodeSlug Products in a category; the full slug path or its last segment
MinPrice, MaxPrice Lowest current price in whole euros
OrderBy, SortDirection Sort order, for example OrderBy=PRICE&SortDirection=ASCENDING

Repeat a parameter for multiple values: Brands=Philips&Brands=Tefal.

Use Skip and Limit (max 100). The total number of matches is in the X-Total-Count header.

Terminal window
curl -s -D - "https://productapiext.reshift.nl/v1/Products?CategoryTreeNodeSlug=televisie&Skip=100&Limit=100" \
-H "Authorization: $RESHIFT_API_KEY" -o page-2.json | grep -i x-total-count

GET /v1/CategoryTreeNodes returns the whole category tree. Use a node’s slug as CategoryTreeNodeSlug. Category names are in Dutch. Products carry the slug of their category in categoryTreeNodeSlug.

If your key is limited to certain categories, products outside them are not returned, and fetching one directly returns 404.

With the Specifications role, product details include specifications, grouped as group → name → value:

"specifications": {
"Algemeen": { "Kleur": "Zwart", "Gewicht": "4,2 kg" },
"Prestaties": { "Vermogen": "1700 W" }
}

GET /v1/Products/{id}/Specifications returns the same data as a flat list, with the unit in suffix. Specification names and values are in Dutch, and which specifications are present differs per product and category.

If you mirror part of the catalog:

  1. Page through GET /v1/Products with your filters once to build the list of ids.
  2. Refresh product details on a slow schedule (daily is plenty); titles and images change rarely.
  3. Fetch prices close to when you show them. See Prices and shops.
  4. Spread scheduled runs over time instead of firing them all at once. See Rate limits.