Rohlik API & Scraper
Rohlik is the largest online supermarket in Czechia, and the same group runs Knuspr in Germany, Gurkerl in Austria, Kifli in Hungary and Sezamo in Romania on one platform, so one API reads all five shops with a country parameter.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`search` returns products for a search term in the shop's language with the price a non-member pays, the regular price it is cut from, the unit price per kg, litre or piece, the Xtra member price kept apart from the price, multi-buy and mix-and-match deals, the same-day-delivery discount, clearance offers on damaged or near-expiry packs with the pieces left, stock, brand and country of origin. `category` lists a department or aisle, `promotions` lists the shop's price-cut shelf or its near-expiry clearance shelf, `categories` returns the category tree, and `product` adds the EAN, description, ingredients, allergens, the nutrition table and shelf life. The price shown on the shop's page can be the Xtra member price: on 2026-10-15 the page of a 1 L milk showed 23.31 CZK while a non-member pays 25.90, so the API returns both and says which one the page shows.
What a Rohlik field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-15.
| Field | What it holds |
|---|---|
| price | What a customer without membership pays for one unit today, including a plain price cut or the shop's long-term low price. Not the member price, not a multi-buy, not the same-day-delivery discount. |
| original_price, discount_pct | The regular price the cut is taken from and the saving, rounded down like the shop prints it (60.90 to 34.90 is -42 %). null when there is no cut. |
| display_price, display_price_is_member_price | The price the shop's page shows a logged-out visitor. It can be the Xtra member price ("-10 % pro vás") or the same-day-delivery price; the flag says when it is the member price. |
| member_price | The Xtra (Premium membership) price. A 1 L milk: price 25.90, member_price 23.31 CZK. |
| same_day_delivery_price | The price that applies only with a same-day delivery slot ("-30 % dnešní doručení"). |
| multi_buy | Deals that need more than one piece: multi_buy ("-19 % od 2 ks", price per piece from 2) and mix_and_match ("-12 % od 2 různých ks", any 2 different items of the same deal). |
| clearance | A separate offer on damaged packs or near-expiry stock ("Poškozený obal"), with its own price and, when the shop limits it, the pieces left. |
| unit_price, unit | Price of `price` per kg, litre or piece. For goods sold by weight the row price is for an estimated piece ("Banán 1 ks cca 190 g") and unit_price is the real price per kg; price_is_estimate is true. |
| ean | The barcode when the shop publishes one. null when the shop has none (the shop then puts its own product id in that field, which is not returned as an EAN). |
| warehouse_id | The warehouse whose stock and prices you see: the shop's default for a visitor without an address. |
Each shop has its own product and category ids and its own currency (CZK, EUR, HUF, RON). Reviews text is not published to a logged-out visitor.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/rohlik/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "mléko",
"country": "cz"
}
}{
"ok": true,
"meta": {
"api": "rohlik",
"endpoint": "search",
"mode": "live",
"latency_ms": 2206.9,
"record_count": 24,
"bytes": 139066,
"cache_hit": false,
"total": 561,
"country": "cz",
"upstream_requests": 3,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "77ff999e1bc34709",
"queue_ms": 1.6,
"fetched_at": "2026-10-15T17:03:00.206Z"
},
"data": {
"query": "mléko",
"corrected_query": null,
"sort": "relevance",
"country": "cz",
"shop": "Rohlik.cz",
"total": 561,
"page": 1,
"page_size": 24,
"returned": 24,
"has_more": true,
"products": [
{
"rank": 1,
"product_id": 1406260,
"title": "Miil Selské čerstvé plnotučné mléko 3,8 % tuku",
"brand": "Miil",
"brand_slug": "miil",
"amount_text": "1 l",
"package_amount": 1,
"package_unit": "l",
"unit": "l",
"sold_by": "unit",
"price_is_estimate": false,
"price": 25.9,
"original_price": null,
"discount_pct": null,
"price_valid_till": null,
"unit_price": 25.9,
"currency": "CZK",
"display_price": 23.31,
"display_price_is_member_price": true,
"member_price": 23.31,
"member_price_program": "Xtra (Premium membership)",
"member_price_welcome_offer": true,
"same_day_delivery_price": null,
"multi_buy": [],
"clearance": null,
"promotions": [
{
"promotion_id": "[trimmed-depth]",
"type": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"min_quantity": "[trimmed-depth]",
"price": "[trimmed-depth]",
"unit_price": "[trimmed-depth]",
"original_price": "[trimmed-depth]",
"valid_till": "[trimmed-depth]",
"active": "[trimmed-depth]",
"welcome_price": "[trimmed-depth]",
"bundle_id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"description": "[trimmed-depth]",
"reason": "[trimmed-depth]"
}
],
"in_stock": true,
"availability": "available",
"unavailability_reason": null,
"max_order_quantity": 50,
"expected_replenishment": null,
"shelf_life": {
"average_days": 10,
"minimal_days": 4,
"best_before": null
},
"warehouse_id": 8791,
"premium_only": false,
"country_of_origin": [
"Česká republika"
],
"country_of_origin_codes": [
"CZ"
],
"main_category_id": 300105002,
"badges": [
"-10 % pro vás",
"Denní kontrola cen",
"Denní kontrola cen"
],
"archived": false,
"image": "https://cdn.rohlik.cz/images/grocery/products/1406260/1406260-1789476753332.jpg",
"url": "https://www.rohlik.cz/1406260-miil-selske-cerstve-plnotucne-mleko-3-8-tuku"
},
{
"rank": 2,
"product_id": 1441838,
"title": "Miil Trvanlivé plnotučné mléko 3,5%",
"brand": "Miil",
"brand_slug": "miil",
"amount_text": "1 l",
"package_amount": 1,
"package_unit": "l",
"unit": "l",
"sold_by": "unit",
"price_is_estimate": false,
"price": 16.9,
"original_price": null,
"discount_pct": null,
"price_valid_till": null,
"unit_price": 16.9,
"currency": "CZK",
"display_price": 15.21,
"display_price_is_member_price": true,
"member_price": 15.21,
"member_price_program": "Xtra (Premium membership)",
"member_price_welcome_offer": true,
"same_day_delivery_price": null,
"multi_buy": [],
"clearance": null,
"promotions": [
{
"promotion_id": "[trimmed-depth]",
"type": "[trimmed-depth]",
"kind": "[trimmed-depth]",
"min_quantity": "[trimmed-depth]",
"price": "[trimmed-depth]",
"unit_price": "[trimmed-depth]",
"original_price": "[trimmed-depth]",
"valid_till": "[trimmed-depth]",
"active": "[trimmed-depth]",
"welcome_price": "[trimmed-depth]",
"bundle_id": "[trimmed-depth]",
"label": "[trimmed-depth]",
"description": "[trimmed-depth]",
"reason": "[trimmed-depth]"
}
],
"in_stock": true,
"availability": "available",
"unavailability_reason": null,
"max_order_quantity": 50,
"expected_replenishment": null,
"shelf_life": {
"average_days": 129,
"minimal_days": 20,
"best_before": null
},
"warehouse_id": 8791,
"premium_only": false,
"country_of_origin": [
"Slovenská republika"
],
"country_of_origin_codes": [
"SK"
],
"main_category_id": 300105003,
"badges": [
"-10 % pro vás",
"Denní kontrola cen",
"Denní kontrola cen"
],
"archived": false,
"image": "https://cdn.rohlik.cz/images/grocery/products/1441838/1441838-1686755946584.jpg",
"url": "https://www.rohlik.cz/1441838-miil-trvanlive-plnotucne-mleko-3-5"
},
{
"rank": 3,
"product_id": 712705,
"title": "Olma Čerstvé mléko polotučné 1,5 %",
"brand": "Olma",
"brand_slug": "olma",
"amount_text": "1 l",
"package_amount": 1,
"package_unit": "l",
"unit": "l",
"sold_by": "unit",
"price_is_estimate": false,
"price": 34.9,
"original_price": null,
"discount_pct": null,
"price_valid_till": null,
"unit_price": 34.9,
"currency": "CZK",
"display_price": 34.9,
"display_price_is_member_price": false,
"member_price": null,
"member_price_program": null,
"member_price_welcome_offer": null,
"same_day_delivery_price": null,
"multi_buy": [],
"clearance": null,
"promotions": [],
"in_stock": true,
"availability": "available",
"unavailability_reason": null,
"max_order_quantity": 50,
"expected_replenishment": null,
"shelf_life": {
"average_days": 5,
"minimal_days": 3,
"best_before": null
},
"warehouse_id": 8791,
"premium_only": false,
"country_of_origin": [
"Česká republika"
],
"country_of_origin_codes": [
"CZ"
],
"main_category_id": 300105002,
"badges": [],
"archived": false,
"image": "https://cdn.rohlik.cz/images/grocery/products/712705/712705-1564577712.jpg",
"url": "https://www.rohlik.cz/712705-olma-cerstve-mleko-polotucne-1-5"
}
]
}
}What the Rohlik API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search one shop of the Rohlik group (CZ / DE / AT / HU / RO) like its search box: price a non-member pays, regular price, unit price, the Xtra member price kept apart, multi-buy and mix-and-match deals, same-day-delivery discount, clearance offer, stock, brand and origin per product. | Pricing teams call search to search one shop of the Rohlik group (CZ / DE / AT / HU / RO) like its search box. | query, country, page, page_size, sort, ... |
| category | Every product of one category (department or aisle) of one shop, paged, with the same rows, sorts and filters as search. | Marketplace operators call category to get every product of one category (department or aisle) of one shop, paged, with the same rows, s…. | category_id, country, page, page_size, sort, ... |
| promotions | The shop's promotion shelves: `sales` = every product with a current price cut or deal (the shop's 'Cenové trháky'), `last_minute` = the near-expiry / damaged-pack clearance shelf ('Zachraň a ušetři'); optionally inside one category, for one brand. | Catalog enrichment teams call promotions to get the shop's promotion shelves. | country, kind, category_id, page, page_size, ... |
| product | One product by the `product_id` a row returns: every price and deal (as search) plus EAN, description, ingredients, allergens, nutrition table per portion, shelf life, country of origin, breadcrumbs and images. | Retail analysts call product to get one product by the `product_id` a row returns. | product_id, country |
| categories | The shop's category tree: without `category_id` the top-level departments with their sub-category ids; with it, that category's sub-categories with names. | Pricing teams call categories to get the shop's category tree. | country, category_id |
Call search from your stack
curl -X POST https://api.reefapi.com/rohlik/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"mléko","country":"cz"}'import requests
r = requests.post(
"https://api.reefapi.com/rohlik/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "mléko",
"country": "cz"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/rohlik/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "mléko",
"country": "cz"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.rohlik.search with {"query":"mléko","country":"cz"}.Who uses this API and why
- Track grocery prices and price cuts across Czechia, Germany, Austria, Hungary and Romania from one API.
- Separate member-only Xtra prices from the price everyone pays when benchmarking online grocery.
- Monitor multi-buy, mix-and-match and clearance offers on the categories you watch.
- Compare unit prices per kg or litre across brands and pack sizes.
- Build a grocery product database with EAN, ingredients, allergens, nutrition and country of origin.
Questions developers ask before integrating
Which shops does it cover?
Rohlik.cz (Czechia, CZK), Knuspr.de (Germany, EUR), Gurkerl.at (Austria, EUR), Kifli.hu (Hungary, HUF) and Sezamo.ro (Romania, RON). Pass country = cz, de, at, hu or ro; product and category ids belong to one shop.
Do I need a Rohlik account or Xtra membership?
No. Everything is read logged out. The Xtra member price is returned as member_price next to the price a non-member pays.
Why is price different from the price on the product page?
Because the page can show the Xtra member price or a same-day-delivery discount. On 2026-10-15 the page's price matched our display_price on 20 of 20 products checked; it matched price on 14 of 20, and the other 6 were member or same-day prices, returned in their own fields.
Which filters and sorts work?
Sort by relevance, price up or down, or unit price; filter by brand and by on-sale. Each was checked against the unfiltered count: "mléko" 561 products, brand Miil 30, Olma 9, on sale 169; the milk category 298, Miil 13, on sale 37. An unknown brand returns a not-found answer instead of the whole catalogue.
What do promotions return?
kind=sales is the shop's price-cut shelf (3,911 products on Rohlik.cz on 2026-10-15); kind=last_minute is the near-expiry and damaged-pack shelf (117). Both can be narrowed to one category or brand.
How are goods sold by weight priced?
The row price is for an estimated piece or pack (a banana of about 190 g: 7.70 CZK) and unit_price is the price per kg (39.90). The final price depends on the weighed piece.
How many products per page?
24 by default, up to 60. Past the last page the answer is an empty page with a note.
How fresh is the data?
Every call reads the shop live; nothing is cached. Price cuts carry their end date in price_valid_till.
What is the Rohlik API?
Rohlik API is a ReefAPI endpoint group for online grocery prices from rohlik.cz, knuspr.de, gurkerl.at, kifli.hu and sezamo.ro: price, unit price, xtra member price, multi-buy deals, stock and product facts. It returns live JSON through POST requests under /rohlik/v1.
Is the Rohlik API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Rohlik calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Rohlik login or account?
No login to Rohlik is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Rohlik data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Rohlik API use?
Rohlik actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Rohlik from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call rohlik actions with the same key, credit pool and JSON envelope used by normal REST requests.