Árukereső / Compari / Pazaruvaj API & Scraper
Árukereső.hu, Compari.ro and Pazaruvaj.com are the largest price-comparison sites of Hungary, Romania and Bulgaria, run by the Heureka Group on one shared catalogue.
🤖 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.
This API reads all three as JSON; choose the site with country = hu, ro or bg. `search` takes product words, an optional price range and six sorts, and returns each product with its lowest price, number of shop offers, rating, review count, brand and category, plus category facets with counts. `category` reads a whole category listing with the category's own product total. `offers` returns every shop for one product in one call: price, the shop's shipping fee and the total when the fee is stated, free-shipping flag, stock and delivery time, the shop's star rating, review count and trusted-shop badge, and whether the row is a sponsored placement. `product` adds the lowest and highest price, offer counts, the 0-5 and 0-100 rating, the full specification sheet and the same product's best price on the two sister sites. `price_history` returns the price chart: lowest and average shop price over time. Product and category ids are the same on all three sites.
What an Árukereső / Compari / Pazaruvaj field actually contains
Fields that read differently from how they look. Every row was measured against live pages of the three sites on 2026-10-15.
| Field | What it holds |
|---|---|
| product_id | The site's product id, digits only (996936880), the number after '-p' in a product URL. The same id is the same product on arukereso.hu, compari.ro and pazaruvaj.com. Pass it unchanged to product, offers and price_history; search to offers to product returned the same id and the same lowest price on 30 of 30 rows across the three countries. |
| row_type | product for a product compared across shops ('N offers'), shop_offer for a single shop's listing (one offer, shop_name set, outbound_url goes to the shop). Price-filtered searches return many shop offers (17 of 20 rows for iPhone 15 between 100 000 and 200 000 HUF). Both kinds open with product and offers. |
| price, currency (bg) | Bulgaria prices in euros: price is the euro amount the page prints (525.00 EUR). The site still carries the lev figure in its data; it is returned apart as price_bgn (1026.81) and never mixed into price. |
| price_from (search, category) | The lowest shop price printed on the listing row. It matched product.lowest_price and the cheapest offer in all three countries (238 990 HUF, 2 970 RON, 525 EUR). |
| shipping_cost, total_price | The delivery fee the shop states ('+ 1 190 Ft'), 0 when it advertises free delivery. A cash-on-delivery or order-handling fee is not a delivery fee: shipping_cost stays null and the text is in shipping_text. total_price is price + shipping_cost, only when the fee is known. |
| listing_type | sponsored for a paid placement (the site's 'featured offers' block), paid for an ordinary listed shop, free for a free listing. Offers come in the site's own order, sponsored rows first. |
| shop_rating_stars, shop_review_count | The shop's rating as the site draws it, in half stars, and the number of shop reviews; null for a shop without reviews. |
| rating, rating_percent | product.rating is the 0-5 average (4.5568), rating_percent the same on the site's 0-100 scale (91); both null when the product has no review. |
| other_countries | The same product's lowest price on the two sister sites, converted by the site into the currency of the site you asked. |
| specs, spec_text | The specification sheet as name / value pairs in groups. A few products carry only a free-text sheet; then specs is null and the text is in spec_text. |
Prices include VAT as the shops list them for delivery in that country. Hungary in HUF, Romania in RON, Bulgaria in EUR.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/arukereso/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone 15",
"country": "hu"
}
}{
"ok": true,
"meta": {
"api": "arukereso",
"endpoint": "search",
"mode": "live",
"latency_ms": 938.6,
"record_count": 20,
"bytes": 314655,
"cache_hit": false,
"last_page": 100,
"upstream_requests": 1,
"country": "hu",
"charged_credits": 3,
"version": "0.1.0",
"request_id": "9e2c5fbeaf8c4c6e",
"queue_ms": 1.7,
"fetched_at": "2026-10-18T11:41:59.689Z"
},
"data": {
"query": {
"query": "iphone 15",
"sort": "relevance",
"min_price": null,
"max_price": null,
"page": 1
},
"country": "hu",
"currency": "HUF",
"page": 1,
"last_page": 100,
"has_more": true,
"page_beyond_last": null,
"page_size": 20,
"redirected_to_category": null,
"results": [
{
"product_id": "996936880",
"row_type": "product",
"title": "Apple iPhone 15 128GB Mobiltelefon",
"url": "https://www.arukereso.hu/mobiltelefon-c3277/apple/iphone-15-128gb-p996936880/",
"brand": "Apple",
"price_from": 233990,
"price_from_text": "233 990 Ft-tól",
"currency": "HUF",
"offer_count": 82,
"shop_name": null,
"outbound_url": null,
"rating_percent": 91,
"review_count": 88,
"category_id": 3277,
"category_path": [
"Műszaki cikk",
"Mobil, navigáció",
"Mobiltelefon"
],
"category_rank": 15,
"image": "https://p1.akcdn.net/thumb/1191449686.apple-iphone-15-128gb.jpg",
"description": "... eljárással gyártott üvegnek és az űrtechnológiai minőségű alumínium háznak köszönhetően az iphone 15 rendkívül tartós. A színek kémiája. A színezést rendkívül kis méretű fémionok...",
"orderable_on_site": true,
"price_max": 515180
},
{
"product_id": "996937006",
"row_type": "shop_offer",
"title": "Apple iPhone 15 Pro 128GB Mobiltelefon",
"url": "https://www.arukereso.hu/mobiltelefon-c3277/apple/iphone-15-pro-128gb-p996937006/",
"brand": "Apple",
"price_from": 389900,
"price_from_text": "389 900 Ft",
"currency": "HUF",
"offer_count": 1,
"shop_name": "skyphone.hu",
"outbound_url": "https://www.arukereso.hu/Jump.php?Id=1601821621&ProductAttributeId=1601821621&ProductType=p&dat=VJLo6ED2n6p2H2oTAk%2FTfQDANK2o9Zew8Z658u0%2F8SZF77W2gXkEpxQKqTWwy%2Fi5miEA%2BNaQeyihl26viu3ECZegP%2F7U3hNYwE3mOVUzCwZG9qTi7xMlel4eIvGrKEpCC57kEWmE2f6OK4KLdToQkicokS2SKodEtIUyh%2BRNRQFWfKL81vIFYO3Px%2FpelIcFtmVIsjuBa3M0fCgDZxGpv6ZH67vo9%2BbulQnCKnzor635h1jd4gqw%2FNADgNxzeT9lxtTgSuknOlya2DK7OV9Yji490B7t3O374xHAdX4cP%2Bv5J9zvWWB%2BOk3eo1MzQtv2iCwl5d4aVeDBq27AmPQ1WkGc3grTo63FMTG4sj6QVYwVduXBcM17ubF0orbskRtgqdKVKAQthdxcdFYBmofMUdX2PG5HTKO1QBRUAcK14Jk%3D&pp=bfdab480c3d0bdd77771e89ed9d1c4ed&ptp=10&ct=norma",
"rating_percent": 89,
"review_count": 40,
"category_id": 3277,
"category_path": [
"Műszaki cikk",
"Mobil, navigáció",
"Mobiltelefon"
],
"category_rank": null,
"image": "https://p1.akcdn.net/thumb/1191449986.apple-iphone-15-pro-128gb.jpg",
"description": "iPhone. Titánból megformálva. Az iphone 15 Pro az első iPhone, amelyhez űrtechnológiai minőségű titánt használtunk, méghozzá a Mars-missziók űrjárműveihez is alkalmazott ötvözetet...",
"orderable_on_site": true,
"price_max": 389900
},
{
"product_id": "996937204",
"row_type": "product",
"title": "Apple iPhone 15 Pro Max 256GB Mobiltelefon",
"url": "https://www.arukereso.hu/mobiltelefon-c3277/apple/iphone-15-pro-max-256gb-p996937204/",
"brand": "Apple",
"price_from": 449990,
"price_from_text": "449 990 Ft-tól",
"currency": "HUF",
"offer_count": 2,
"shop_name": null,
"outbound_url": null,
"rating_percent": 96,
"review_count": 24,
"category_id": 3277,
"category_path": [
"Műszaki cikk",
"Mobil, navigáció",
"Mobiltelefon"
],
"category_rank": null,
"image": "https://p1.akcdn.net/thumb/1191450370.apple-iphone-15-pro-max-256gb.jpg",
"description": "iPhone. Titánból megformálva. Az iphone 15 Pro Max az első iPhone, amelyhez űrtechnológiai minőségű titánt használtunk, méghozzá a Mars-missziók űrjárműveihez is alkalmazott ötvözetet...",
"orderable_on_site": true,
"price_max": 449990
}
],
"category_facets": [
{
"name": "Műszaki cikk",
"count": 25979
},
{
"name": "Számítógép",
"count": 450
},
{
"name": "Építkezés, felújítás",
"count": 109
}
]
}
}What the Árukereső / Compari / Pazaruvaj API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword search across the whole catalogue of one country's site. Each row is a product with its lowest price ('from'), the number of shop offers, rating, review count, brand and category. Optional price range and sort. | Pricing teams call search to get keyword search across the whole catalogue of one country's site. | query, country, min_price, max_price, sort, ... |
| category | One category's product listing (e.g. 3277 = mobile phones), with the category's own product total, sort and paging. Category ids are shared by the three sites. | Marketplace operators call category to get one category's product listing (e.g. | category, country, sort, page |
| product | One product page: title, brand, category path, lowest and highest current price, offer counts (paid / sponsored / free listings), rating (0-5 and 0-100) with review count, the full specification sheet, and the same product's best price on the two sister sites (converted by the site). | Catalog enrichment teams call product to get one product page. | product_id, url, country |
| offers | Every shop offer for one product, in the site's own order: shop, price, shipping fee and total (when the fee is stated), free-shipping flag, stock, delivery time, shop star rating and review count, trusted-shop badge, whether the row is a sponsored placement, and the click-through link. | Retail analysts call offers to get every shop offer for one product, in the site's own order. | product_id, url, country |
| price_history | The product's price chart as the site draws it: the lowest and the average shop price over time (points roughly monthly, then denser). | Pricing teams call price_history to get the product's price chart as the site draws it. | product_id, url, country |
Call search from your stack
curl -X POST https://api.reefapi.com/arukereso/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15","country":"hu"}'import requests
r = requests.post(
"https://api.reefapi.com/arukereso/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 15",
"country": "hu"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/arukereso/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone 15",
"country": "hu"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.arukereso.search with {"query":"iphone 15","country":"hu"}.Who uses this API and why
- Monitor the cheapest shop price for a product list in Hungary, Romania and Bulgaria every day.
- Compare one product's price across the three countries with the same product id.
- Track which shops pay for featured placement on a product, and at what price.
- Build price-history datasets of the lowest and average shop price per product.
- Map a category's catalogue with prices, offer counts, ratings and specs.
Questions developers ask before integrating
Do I need an account on these sites?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Which countries are covered?
Hungary (arukereso.hu), Romania (compari.ro) and Bulgaria (pazaruvaj.com), one parameter: country = hu, ro or bg. The same product_id works in each country where the product is listed.
How many shops does offers return?
All shops on the product page in one call: 46 for an iPhone 15 in Hungary, 29 in Romania and 14 in Bulgaria on 2026-10-15. Rows the site repeats in its 'buy here' block are returned once.
Is shipping included?
Where the shop states a delivery fee, yes: shipping_cost and total_price. Many shops print only stock or a delivery-time line, or a cash-on-delivery fee; then shipping_cost is null instead of a guess.
Which search filters are there?
A price range and six sorts. Checked against the unfiltered search in the same run: "iphone 15" across 100 result pages → 100 000 to 200 000 HUF 6 pages, 20 of 20 rows in range; price ascending and descending were in order on 20 of 20 rows.
How far back does price_history go?
To when the site first charted the product: September 2023 for the iPhone 15, 30 points with the lowest and the average shop price. The last point is the last full day.
Can I list a whole category?
Yes, 25 products per page with the category's own total: mobile phones had 986 products in Hungary, 1 326 in Romania and 1 124 in Bulgaria on 2026-10-15.
Are Bulgarian prices in leva or euros?
Euros, as the site prints them since Bulgaria adopted the euro. The lev amount the site still keeps is returned separately as price_bgn.
What is the Árukereső / Compari / Pazaruvaj API?
Árukereső / Compari / Pazaruvaj API is a ReefAPI endpoint group for price comparison for hungary, romania and bulgaria: every shop's offer with shipping, specs, price history and category listings. It returns live JSON through POST requests under /arukereso/v1.
Is the Árukereső / Compari / Pazaruvaj API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Árukereső / Compari / Pazaruvaj calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Árukereső / Compari / Pazaruvaj login or account?
No login to Árukereső / Compari / Pazaruvaj 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 Árukereső / Compari / Pazaruvaj 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 Árukereső / Compari / Pazaruvaj API use?
Árukereső / Compari / Pazaruvaj 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 Árukereső / Compari / Pazaruvaj from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call arukereso actions with the same key, credit pool and JSON envelope used by normal REST requests.