# Hoogvliet Dutch Supermarket Products API

> Hoogvliet Netherlands: supermarket product search with prices, offers, Nutri-Score, GTIN and stock

- Vendor: `hoogvlietdutchsupermarketprodu` · version 1.0 · category Food · tags hoogvliet api, dutch supermarket api, dutch grocery prices api, nutri-score api, gtin products api, supermarket offers api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/hoogvlietdutchsupermarketprodu
- This document: https://apiclay.com/docs/hoogvlietdutchsupermarketprodu.md
- OpenAPI 3.1: https://apiclay.com/api/hoogvlietdutchsupermarketprodu/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `hoogvlietdutchsupermarketprodu`
- Updated: 2026-11-18

## About

## Hoogvliet Dutch Supermarket Products API

The product search of Hoogvliet, the Dutch supermarket chain: find groceries by keyword, page by page, each with name and display name, brand, GTIN-13, Nutri-Score, regular and final price with discount, offer labels, stock status, maximum order quantity, product flags and link, plus the result facets.

Data comes from **hoogvliet.nl** (https://www.hoogvliet.nl). Every route calls the source's own public API and returns it unchanged.

Typical flow: POST `/search` with the sample body (change `inputText` and `page`).

### Routes

#### POST `/search` - Search products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| type | body | string | yes | `realtimeSearch`. |
| args | body | object | yes | `{"page": 1, "filter": {}, "inputText": "melk"}`: `inputText` is the search text, `page` from 1. |

Returns: `data.result`: `items` (`id`, `name`, `display_name`, `brand`, `gtin13`, `nutrition_score`, `price_range` with `regular_price`, `final_price` and `discount`, `discount_label`, `is_promotion`, `stock_status`, `max_sale_qty`, `product_flags`, `product_link`), `aggregations`, `sort_options`, `hasNextPage`, `nextPageValue`.

### Caveats

- Prices are Hoogvliet's online prices and can differ in stores.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by hoogvliet.nl.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /search — Search products
- Gateway: `POST https://api.apiclay.com/v1/api/hoogvlietdutchsupermarketprodu/search`
- Body sample (JSON):

```json
{"type": "realtimeSearch", "args": {"page": 1, "filter": {}, "inputText": "melk"}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/hoogvlietdutchsupermarketprodu/search" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"type": "realtimeSearch", "args": {"page": 1, "filter": {}, "inputText": "melk"}}'
```

Index of every published API: https://apiclay.com/llms.txt
