Skip to content

Quickstart

You need an API key. Keys are issued by Kieskeurig; ask your contact person if you don’t have one yet.

  1. Check your key. Every request sends the key as the bare value of the Authorization header, with no Bearer prefix.

    Terminal window
    curl -s "https://productapiext.reshift.nl/v1/Shops?Limit=5" \
    -H "Authorization: $RESHIFT_API_KEY" \
    -H "Accept: application/json"

    A 200 with a list of shops means your key works. A 401 means the key is missing or wrong.

  2. Find a product. Search by EAN, text, brand or category. Results are paged with Skip and Limit (max 100); the total is in the X-Total-Count header.

    Terminal window
    curl -s "https://productapiext.reshift.nl/v1/Products?Query=airfryer&Limit=5" \
    -H "Authorization: $RESHIFT_API_KEY"

    To look up a product you already know, use Ean=<ean> instead of Query.

    Keep the id (a GUID) of the product. It is the stable identifier you should store.

  3. Get the current prices.

    Terminal window
    curl -s "https://productapiext.reshift.nl/v1/Products/{id}/Prices" \
    -H "Authorization: $RESHIFT_API_KEY"

    Each offer has the shop, the price including and excluding delivery, delivery information and a clickout link. Send your users’ clicks through that link unchanged; see Affiliate ids and clickouts.

const BASE = 'https://productapiext.reshift.nl/v1';
const headers = { Authorization: process.env.RESHIFT_API_KEY, Accept: 'application/json' };
const search = await fetch(`${BASE}/Products?Query=airfryer&Limit=10`, { headers });
const total = Number(search.headers.get('X-Total-Count'));
const products = await search.json();
const prices = await fetch(`${BASE}/Products/${products[0].id}/Prices`, { headers });
if (prices.status === 404) {
// No current offers in your market: show the product as unavailable.
} else {
console.log(total, await prices.json());
}
Base URL https://productapiext.reshift.nl/v1
Format JSON, UTF-8, camelCase property names
Dates ISO 8601 in UTC, for example 2026-11-19T14:00:00Z
Amounts Euros as decimal numbers
Enums UPPER_SNAKE_CASE, for example OrderBy=MOST_VIEWED
Lists in the query Repeat the parameter: Brands=Philips&Brands=Tefal
Paging Skip and Limit; total in the X-Total-Count response header
Compression Send Accept-Encoding: gzip for smaller responses