Quickstart
You need an API key. Keys are issued by Kieskeurig; ask your contact person if you don’t have one yet.
-
Check your key. Every request sends the key as the bare value of the
Authorizationheader, with noBearerprefix.Terminal window curl -s "https://productapiext.reshift.nl/v1/Shops?Limit=5" \-H "Authorization: $RESHIFT_API_KEY" \-H "Accept: application/json"A
200with a list of shops means your key works. A401means the key is missing or wrong. -
Find a product. Search by EAN, text, brand or category. Results are paged with
SkipandLimit(max 100); the total is in theX-Total-Countheader.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 ofQuery.Keep the
id(a GUID) of the product. It is the stable identifier you should store. -
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.
The same in code
Section titled “The same in code”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());}import osimport requests
BASE = "https://productapiext.reshift.nl/v1"session = requests.Session()session.headers.update({"Authorization": os.environ["RESHIFT_API_KEY"], "Accept": "application/json"})
search = session.get(f"{BASE}/Products", params={"Query": "airfryer", "Limit": 10})search.raise_for_status()total = int(search.headers["X-Total-Count"])products = search.json()
prices = session.get(f"{BASE}/Products/{products[0]['id']}/Prices")if prices.status_code == 404: pass # No current offers in your market: show the product as unavailable.else: prices.raise_for_status() print(total, prices.json())using System.Net.Http.Json;
var http = new HttpClient { BaseAddress = new Uri("https://productapiext.reshift.nl/v1/") };http.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", Environment.GetEnvironmentVariable("RESHIFT_API_KEY"));
var search = await http.GetAsync("Products?Query=airfryer&Limit=10");search.EnsureSuccessStatusCode();var total = int.Parse(search.Headers.GetValues("X-Total-Count").First());var products = await search.Content.ReadFromJsonAsync<List<ProductListing>>();
var prices = await http.GetAsync($"Products/{products![0].Id}/Prices");if (prices.StatusCode != System.Net.HttpStatusCode.NotFound){ prices.EnsureSuccessStatusCode();}
record ProductListing(Guid Id, string Title);TryAddWithoutValidation is needed because .NET otherwise expects an Authorization header to have a scheme.
Conventions
Section titled “Conventions”| 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 |
Next steps
Section titled “Next steps”- Authentication and roles: which endpoints your key can use.
- Rate limits and errors: before you go to production.
- API reference: every endpoint, parameter and field.