Base URL
https://content.winkelstraat.nl
The Winkelstraat.nl Content API lets partners (retailers and brands) deliver their product catalogue to Winkelstraat.nl and keep it up to date: product information, prices, stock and images.
What you can do with this API
- Create and update products: one call per size, including descriptions, prices, stock and image URLs.
- Update a single value, such as stock or price, without sending the whole product.
- Delete products that you no longer sell on Winkelstraat.nl.
- Upload images, either as a URL in the product or as a file.
- Look up reference data: categories, attributes and the allowed values of attributes such as brand, colour and size.
- See which products Winkelstraat asks you to send again (renewal).
When to use it
Use the Content API when you want to connect your own PIM, ERP or webshop directly to Winkelstraat.nl, so that new products, price changes and stock changes reach us automatically. Typical patterns:
- send a product (all its sizes) once when it is added to your range;
- send stock and price changes as soon as they happen, using
PATCH /api/rest/v1/retailer/products/{code}/attribute/{attribute_code}; - delete a size when you stop selling it on Winkelstraat.nl.
Getting started
- Request staging credentials from partnersuccess@winkelstraat.nl.
- Request an access token (see Authentication).
- Look up the category codes and the allowed attribute values (see Attribute values).
- Send one or more test products on staging, preferably with several sizes.
- Winkelstraat checks your test products. Once they are approved you receive production credentials and can go live (see Environments and going live).
The topics below explain the concepts once. The endpoint pages then list, per endpoint, its purpose, the required and optional fields, the possible values, an example request, an example response and the possible errors.
This is version 1.1.0 of this API documentation. Last update on Oct 15, 2026.