Unieuro API & Scraper
Unieuro is Italy's largest consumer-electronics and home-appliance chain (phones, laptops, TVs, washing machines, fridges, small appliances) with about 500 stores.
🤖 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 unieuro.it as JSON. `search` takes Italian or brand/model keywords and `category` lists one Unieuro category by its code or page URL; both filter by brand, price range in euro, available online now, in promotion, free delivery and minimum rating, and sort by price. Each row returns the product code, EAN, manufacturer part number, brand, title, URL, image, the price you pay now, the manufacturer's suggested price, the EU Omnibus prior price ('Prezzo precedente') when the site shows one, the struck-through price, the Unieuro Club price, the promotion, online stock status, the home-delivery and store-pickup date windows with their cost, the rating and the category path. `product` adds the live online stock level, the promotion end date, price validity dates, specifications with units, images, videos and the optional services with prices. `reviews` returns the customer reviews, `store_availability` says whether one store can hand over a product and from which date, `stores` lists the store network with opening hours, and `categories` the category tree.
What a Unieuro field actually contains
Fields that read differently from how they look. Every row was measured against live Unieuro responses on 2026-10-15.
| Field | What it holds |
|---|---|
| price | What the buyer pays now, in euro, VAT included: the 'Ora € …' figure on the product page. |
| recommended_retail_price | The manufacturer's suggested price ('Prezzo consigliato'). It is not a price Unieuro charged before. |
| omnibus_prior_price | The EU Omnibus reference ('Prezzo precedente'): the lowest price Unieuro applied in the 30 days before the promotion started. Null when the page shows none; omnibus_applies says which. |
| crossed_out_price | The struck-through price ('Prezzo barrato'). Returned only when it is higher than the price; the product's crossed_out_price_note gives the site's own explanation of the period it refers to. |
| club_price | The price for Unieuro Club card holders on the few products with a club-only promotion. It is not the public price. |
| stock_status, stock_level | stock_status is inStock, lowStock or outOfStock for online sale; product adds stock_level, the online stock count the site reports. |
| rating | The average of the reviews written on Unieuro. The reviews action also returns reviews the review provider brings in from other retailers for the same product; each row says where it came from. |
| code, url_code | code is Unieuro's product code (APLIPHONE15128). A few codes contain + or /; url_code is the form used in the page URL. product and store_availability take either; reviews take code. |
On 12 products from 8 searches, measured twice, the search row, the product record and the price printed on the product page agreed on the price 12 of 12 times, on the Omnibus prior price 12 of 12 (2 shown, 10 without one on both sides) and on the suggested price 12 of 12.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/unieuro/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "lavatrice",
"limit": 24
}
}{
"ok": true,
"meta": {
"api": "unieuro",
"endpoint": "search",
"mode": "live",
"latency_ms": 274.2,
"record_count": 24,
"bytes": 51390,
"cache_hit": false,
"upstream_requests": 1,
"total": 477,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "a027e52b1ee04127",
"queue_ms": 1,
"fetched_at": "2026-10-15T17:02:59.546Z"
},
"data": {
"results": [
{
"code": "INDIMA762MYTIMEIT",
"url_code": "INDIMA762MYTIMEIT",
"ean": "8050147722381",
"manufacturer_part_number": "869991722380",
"title": "Indesit Lavatrice a libera installazione IMA 762 MY TIME IT - IMA 762 MY TIME IT",
"brand": "Indesit",
"url": "https://www.unieuro.it/online/Lavatrici/Lavatrice-a-libera-installazione-Indesit-IMA-762-MY-TIME-IT---IMA-762-MY-TIME-IT-pidINDIMA762MYTIMEIT",
"image": "https://www.unieuro.it/medias/sys_master/root/hd2/hd6/49568229720094/-api-rest-00ed29448a7522f610cac04d7b9ea7e0-assets-d6b462b2b2b59576e58450f3b9ef8641-preview-sgmConversionBaseFormat-sgmProductFormat.jpg",
"currency": "EUR",
"price": 249.9,
"recommended_retail_price": 429.9,
"omnibus_prior_price": null,
"omnibus_applies": false,
"crossed_out_price": null,
"discount_percent": 41,
"club_price": null,
"club_only_promotion": false,
"installment_amount": null,
"on_promotion": true,
"promotion_title": "VOLANTINO",
"promotion_days_left": 14,
"in_stock": true,
"stock_status": "inStock",
"free_delivery": true,
"home_delivery": {
"from": "2026-10-20",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuita"
},
"store_pickup": {
"from": "2026-10-16",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuito"
},
"rating": 4.5,
"category": "Lavatrici",
"category_code": "C7108",
"category_path": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"energy_class": "A",
"new_product": false,
"preorder": false,
"key_features": {
"Tipo di carica": "Caricamento frontale",
"Larghezza": "600 mm",
"Colore del prodotto": "Bianco",
"Partenza differita": null,
"Capacità cestello": "7 kg",
"Altezza": "850 mm",
"Posizionamento dell'apparecchio": "Libera installazione",
"Profondità": "474 mm",
"Velocità di centrifuga massima": "1200 RPM"
}
},
{
"code": "INDMTWC71296WIT",
"url_code": "INDMTWC71296WIT",
"ean": "8050147717615",
"manufacturer_part_number": "869991717610",
"title": "Indesit Lavatrice a libera installazione MTWC 71296 W IT - MTWC 71296 W IT",
"brand": "Indesit",
"url": "https://www.unieuro.it/online/Lavatrici/Lavatrice-a-libera-installazione-Indesit-MTWC-71296-W-IT---MTWC-71296-W-IT-pidINDMTWC71296WIT",
"image": "https://www.unieuro.it/medias/sys_master/root/he9/hd2/49570309242910/-api-rest-00ed29448a7522f610cac04d7b9ea7e0-assets-b9b1a47988864af57024b17f44595eff-preview-sgmConversionBaseFormat-sgmProductFormat.jpg",
"currency": "EUR",
"price": 249.9,
"recommended_retail_price": 399.9,
"omnibus_prior_price": null,
"omnibus_applies": false,
"crossed_out_price": null,
"discount_percent": 37,
"club_price": null,
"club_only_promotion": false,
"installment_amount": null,
"on_promotion": true,
"promotion_title": "TECH COLLECTION",
"promotion_days_left": 14,
"in_stock": true,
"stock_status": "inStock",
"free_delivery": true,
"home_delivery": {
"from": "2026-10-20",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuita"
},
"store_pickup": {
"from": "2026-10-16",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuito"
},
"rating": 4.8,
"category": "Lavatrici",
"category_code": "C7101",
"category_path": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"energy_class": "A",
"new_product": false,
"preorder": false,
"key_features": {
"Tipo di carica": "Caricamento frontale",
"Larghezza": "595 mm",
"Colore del prodotto": "Bianco",
"Partenza differita": null,
"Capacità cestello": "7 kg",
"Altezza": "850 mm",
"Posizionamento dell'apparecchio": "Libera installazione",
"Profondità": "540 mm",
"Velocità di centrifuga massima": "1200 RPM"
}
},
{
"code": "BOHWAN28228IT",
"url_code": "BOHWAN28228IT",
"ean": "4242005532612",
"manufacturer_part_number": "WAN28228IT",
"title": "Bosch Serie 4 WAN28228IT Lavatrice a carica frontale 8kg 1400g/min Bianco Classe A",
"brand": "Bosch",
"url": "https://www.unieuro.it/online/Lavatrici/WAN28228IT-Serie-4-Lavatrice-a-carica-frontale-8kg-1400g-min-Bianco-Classe-A-pidBOHWAN28228IT",
"image": "https://www.unieuro.it/medias/sys_master/root/hbc/h05/51207507410974/-api-rest-00ed29448a7522f610cac04d7b9ea7e0-assets-fc665b23cf17b2ee9ddff705136ee7e5-preview-sgmConversionBaseFormat-sgmProductFormat.jpg",
"currency": "EUR",
"price": 389.9,
"recommended_retail_price": 699.9,
"omnibus_prior_price": null,
"omnibus_applies": false,
"crossed_out_price": null,
"discount_percent": 44,
"club_price": null,
"club_only_promotion": false,
"installment_amount": null,
"on_promotion": true,
"promotion_title": "TECH COLLECTION",
"promotion_days_left": 14,
"in_stock": true,
"stock_status": "inStock",
"free_delivery": true,
"home_delivery": {
"from": "2026-10-20",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuita"
},
"store_pickup": {
"from": "2026-10-16",
"to": "2026-10-25",
"cost": 0,
"cost_text": "Gratuito"
},
"rating": 4.8,
"category": "Lavatrici",
"category_code": "C7101",
"category_path": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"energy_class": "A",
"new_product": false,
"preorder": false,
"key_features": {
"Tipo di carica": "Caricamento frontale",
"Larghezza": "598 mm",
"Colore del prodotto": "Bianco",
"Partenza differita": null,
"Capacità cestello": "8 kg",
"Altezza": "845 mm",
"Posizionamento dell'apparecchio": "Libera installazione",
"Profondità": "590 mm",
"Velocità di centrifuga massima": "1400 RPM"
}
}
],
"total": 477,
"pages": 20,
"page": 1,
"limit": 24,
"has_more": true,
"page_capped": false,
"sort": "relevance",
"query": "lavatrice"
}
}What the Unieuro API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search unieuro.it by keyword with the site's own brand, price (EUR), in-stock, promotion, free-delivery and rating filters and its price sorts. Each row: code, EAN, brand, title, URL, image, the price you pay now, the manufacturer's suggested price, the EU Omnibus prior price ('Prezzo precedente') when shown, the struck-through price, the Unieuro Club price, promotion, online stock status, home-delivery and store-pickup windows with costs, rating and category path. The source serves the first 1000 hits of a query. | Pricing teams call search to search unieuro.it by keyword with the site's own brand, price (EUR), in-stock, promotion, fre…. | query |
| category | List one unieuro.it category by its code (C2102 = iPhone, C21 = Smartphones and phones) or its page URL, optionally narrowed by words, with the same filters and sorts as search. | Marketplace operators call category to list one unieuro.it category by its code (C2102 = iPhone, C21 = Smartphones and phones) or it…. | none |
| product | Full product record: price you pay now, suggested price, EU Omnibus prior price with its label, struck-through price with the site's note, discount, promotion and its end date, price validity dates, live online stock level and status, home-delivery and store-pickup windows and costs, instalment amount, loyalty points, rating, description, specifications (grouped, with units), images, videos, category path and the optional services (installation, warranty, WEEE pickup) with prices. | Catalog enrichment teams call product to get full product record. | none |
| reviews | Customer reviews of one product as published by the site's review provider, newest first, optionally one star rating or one language. Includes reviews the provider syndicates from other retailers for the same product — each row says which retailer it came from; locale=it_IT keeps the Italian reviews. | Retail analysts call reviews to get customer reviews of one product as published by the site's review provider, newest first, opt…. | none |
| store_availability | Can this product be collected at this store, and when: the store-pickup answer and date window the product page shows after choosing a store. One product, one store per call. | Pricing teams call store_availability to get can this product be collected at this store, and when. | none |
| stores | Unieuro's store directory: id, code, name, address, city, province, region, coordinates, phone, opening hours, special openings and in-store services. With latitude/longitude it returns the stores within radius_km sorted by distance; without, the whole network, optionally narrowed by city, province or region. | Marketplace operators call stores to get unieuro's store directory. | none |
| categories | The full category tree, flattened: code (feed it to category / search), name, parent, level, readable path and page URL. Optional text match. | Catalog enrichment teams call categories to get the full category tree, flattened. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/unieuro/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lavatrice","limit":24}'import requests
r = requests.post(
"https://api.reefapi.com/unieuro/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "lavatrice",
"limit": 24
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/unieuro/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "lavatrice",
"limit": 24
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.unieuro.search with {"query":"lavatrice","limit":24}.Who uses this API and why
- Track Unieuro prices, promotions and the Omnibus prior price day by day for EU price-claim checks.
- Compare Unieuro with MediaWorld and other Italian shops by EAN.
- Watch online stock levels and delivery windows on fast-moving products.
- Check which Unieuro store can hand over a product and from which date.
- Build a store locator feed with addresses, coordinates and opening hours.
Questions developers ask before integrating
Do I need a Unieuro account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Is the EU Omnibus 30-day price included?
Yes, as omnibus_prior_price, exactly when the product page shows a 'Prezzo precedente'. It is kept apart from the suggested price and the struck-through price.
Do the filters work?
Each was checked against the unfiltered count in the same run. 'lavatrice' 477 products: Samsung 25, 300-500 euro 211, available online 352, in promotion 318, free delivery 473, rated 4 stars or more 174. An unknown brand returns no products rather than everything.
Can I check a specific store?
Yes. stores gives each store's store_id; store_availability with a product code and that store_id says whether the store can hand it over and the pickup date window. Unieuro does not publish per-store quantities.
How many results can I get?
Up to 100 products per page and the first 1,000 matches of any search or category; narrow with filters or a category to reach the rest. The total still counts every match (21,048 products in the whole catalogue).
Why do some reviews come from other shops?
Unieuro's review provider shares reviews of the same product from other retailers. Each review carries source_merchant and syndicated; locale=it_IT keeps the Italian reviews (for the iPhone 15: 14 of 754).
What is the Unieuro API?
Unieuro API is a ReefAPI endpoint group for italy's largest electronics retailer: eur prices, the eu omnibus prior price, suggested price, online stock, delivery windows, specs, reviews and stores. It returns live JSON through POST requests under /unieuro/v1.
Is the Unieuro API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Unieuro calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Unieuro login or account?
No login to Unieuro 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 Unieuro 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 Unieuro API use?
Unieuro 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 Unieuro from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call unieuro actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Unieuro API an Unieuro scraper?
It is the managed alternative to a DIY Unieuro scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same italy's largest electronics retailer: eur prices, the eu omnibus prior price, suggested price, online stock, delivery windows, specs, reviews and stores back as clean JSON.
Why does my Unieuro scraper keep getting blocked?
Most Unieuro scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.