Products
Identifiers
Section titled “Identifiers”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=….
Searching and filtering
Section titled “Searching and filtering”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.
Paging
Section titled “Paging”Use Skip and Limit (max 100). The total number of matches is in the X-Total-Count header.
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-countCategories
Section titled “Categories”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.
Specifications
Section titled “Specifications”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.
Keeping a local copy in sync
Section titled “Keeping a local copy in sync”If you mirror part of the catalog:
- Page through
GET /v1/Productswith your filters once to build the list ofids. - Refresh product details on a slow schedule (daily is plenty); titles and images change rarely.
- Fetch prices close to when you show them. See Prices and shops.
- Spread scheduled runs over time instead of firing them all at once. See Rate limits.