Skip to content
Scrappa Get API key
HEMA API 3 credits / request

HEMA Search API Documentation

GET https://scrappa.co/api/hema/search

Search the public HEMA catalogue. Returns rich cards with numeric EUR prices, promotion flags, full-size image URLs, ratings and stock flags. Sort is a site sort identifier. Cost: 3 credits per successful request.

HEMA Search API Documentation 3 credits / request

Endpoint

Request preview
GET
https://scrappa.co/api/hema/search
Auth header
x-api-key
Cost
3 credits / request
query = coffee shops
Response preview
200 OK
Example JSON appears below when a response schema is available for this endpoint.

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

7 optional filters available.

query string Required

Search text. Required.

Example value coffee shops
page integer Optional

Page number, default 1.

Example value 1
sort string Optional

Site sort identifier passed as srule.

Example value relevance
min_price number Optional

Optional lowest EUR price.

Example value 10
max_price number Optional

Optional highest EUR price.

Example value 10
facet_name string Optional

Upstream prefn1 name.

Example value example
facet_value string Optional

Upstream prefv1 value.

Example value example
site string Optional

nl or nl-be, default nl.

Example value example

Errors

Handle these documented responses before retrying or showing customer-facing failures.

UPSTREAM_BLOCKED

HTTP UPSTREAM_BLOCKED

The public source blocked the lookup. No credit is charged.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.