# idealo API > idealo returns product prices and shop offers through a workflow and API. idealo, also known as idealo.de, compares a product across online shops in the chosen country and returns offers, prices, and shop details. Compare prices needs a product name and accepts an optional country and maximum number of offers. - Page: https://fous.com/workflows/idealo - Handle: `@idealo` - Category: [Commerce](https://fous.com/workflows/category/commerce) - Source website: https://idealo.de - Last verified: Sep 29, 2026 - Fous is not affiliated with idealo. ## Methods ### Compare prices Operation `compare_prices`, version 1. 1 credit per call. Compare the best-matching product across online shops in the chosen idealo country. Prices include shipping where shown; price trend is unavailable when the public chart has no readable value. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `country` | string | no | `"United Kingdom"` | Country name or two-letter code, for example Germany or DE. | | `product` | string | yes | `"Sony WH-1000XM5"` | Product name to compare, for example Sony WH-1000XM5. | | `max_offers` | integer | no | `25` | Maximum number of cheapest offers to return, for example 20. | **Input schema** ```json { "type": "object", "required": [ "product" ], "properties": { "country": { "type": "string", "default": "Germany", "description": "Country name or two-letter code, for example Germany or DE.", "examples": [ "United Kingdom", "France" ] }, "product": { "type": "string", "description": "Product name to compare, for example Sony WH-1000XM5.", "examples": [ "Sony WH-1000XM5", "Dyson V15" ] }, "max_offers": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of cheapest offers to return, for example 20.", "x-fous-developer": true, "examples": [ 25, 5 ] } }, "additionalProperties": false, "examples": [ { "country": "United Kingdom", "product": "Sony WH-1000XM5", "max_offers": 25 }, { "product": "Sony WH-1000XM5" }, { "country": "France", "product": "Dyson V15", "max_offers": 5 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `offers` | array | | | | `offers[].price` | number or null | `189` | | | `offers[].shop_name` | string or null | `"Amazon"` | | | `offers[].offer_link` | string or null | `"https://www.idealo.de/relocator/relocate?categoryId=2520&offerKey=325a69d53fac0738735c0d42da62821a&pos=1&price=189.00&p` | | | `offers[].shop_rating` | string or null | `"2,3"` | | | `offers[].total_price` | number or null | `189` | | | `offers[].delivery_time` | string or null | `"Auf Lager"` | | | `offers[].shipping_cost` | number or null | `0` | | | `offers[].shop_rating_count` | integer or null | `1797` | | | `currency` | string | `"EUR"` | | | `price_trend` | string or null | | | | `lowest_price` | number or null | `189` | | | `product_name` | string | `"Sony WH-1000XM5"` | | | `number_of_offers` | integer | `97` | | | `idealo_product_link` | string | `"https://www.idealo.de/preisvergleich/OffersOfProduct/201949755_-wh-1000xm5-sony.html"` | | **Example input** ```json { "product": "Sony WH-1000XM5" } ``` **Example output** ```json { "offers": [ { "price": 189, "shop_name": "Amazon", "offer_link": "https://www.idealo.de/relocator/relocate?categoryId=2520&offerKey=325a69d53fac0738735c0d42da62821a&pos=1&price=189.00&productid=201949755&sid=4640&type=offer", "shop_rating": "2,3", "total_price": 189, "delivery_time": "Auf Lager", "shipping_cost": 0, "shop_rating_count": 1797 }, { "price": 189, "shop_name": "joybuy.de", "offer_link": "https://www.idealo.de/relocator/relocate?categoryId=2520&offerKey=3430badbdeed36644523c6aac77a6adc&pos=2&price=189.00&productid=201949755&sid=335764&type=offer", "shop_rating": "2,7", "total_price": 189, "delivery_time": "Lieferung am selben Tag oder am nächsten Tag", "shipping_cost": 0, "shop_rating_count": 145 }, { "price": 189, "shop_name": "joybuy.de", "offer_link": "https://www.idealo.de/relocator/relocate?categoryId=2520&offerKey=647e4634560b011f6a6a3530ee9daad4&pos=3&price=189.00&productid=201949755&sid=335764&type=offer", "shop_rating": "2,7", "total_price": 189, "delivery_time": "Lieferung am selben Tag oder am nächsten Tag", "shipping_cost": 0, "shop_rating_count": 145 } ], "currency": "EUR", "price_trend": null, "lowest_price": 189, "product_name": "Sony WH-1000XM5", "number_of_offers": 97, "idealo_product_link": "https://www.idealo.de/preisvergleich/OffersOfProduct/201949755_-wh-1000xm5-sony.html" } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@idealo", "visibility": "public", "operation": "compare_prices", "version": 1, "input": { "country": "United Kingdom", "product": "Sony WH-1000XM5", "max_offers": 25 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@idealo\",\n \"visibility\": \"public\",\n \"operation\": \"compare_prices\",\n \"version\": 1,\n \"input\": {\n \"country\": \"United Kingdom\",\n \"product\": \"Sony WH-1000XM5\",\n \"max_offers\": 25\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@idealo", "visibility": "public", "operation": "compare_prices", "version": 1, "input": { "country": "United Kingdom", "product": "Sony WH-1000XM5", "max_offers": 25 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@idealo","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## Use cases - Compare total prices across shops, including shipping where shown - Identify the lowest price for a product - Review shop ratings and delivery times - Track product price trends when a readable chart value is available ## FAQ ### Is Fous affiliated with idealo? No. Fous is not affiliated with idealo. This workflow reads the public idealo.de website and returns its data. ### How much does it cost? Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit. ### Do I need a idealo account? No. You only need a Fous account. ### How current is the data? Fous gets the data from idealo.de when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026. ### Which shops offer this product, and at what prices? Compare prices returns matching shop offers, prices, and delivery details for the product and chosen country. ### What is the lowest price for this product? Compare prices returns the lowest price among the matching offers. ### Is a price trend available for this product? Compare prices returns a price trend when the public chart has a readable value. ## Related - [PriceRunner API](https://fous.com/workflows/pricerunner.md): Compare prices for products offered by online shops. - [IKEA API](https://fous.com/workflows/ikea.md): IKEA helps shoppers find country-dependent product details, prices, photos, reviews and assembly information, and check store stock where IKEA provides it; some countries are unsupported. - [Google Shopping API](https://fous.com/workflows/google-shopping.md): Google Shopping shows product offers, prices, ratings, delivery and store links; results vary by country and listings, totals need shown shipping, and typical ranges may be missing. - [Zalando API](https://fous.com/workflows/zalando.md): Search clothes and shoes on Zalando country shops. - [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access. - [AliExpress API](https://fous.com/workflows/aliexpress.md): AliExpress returns product listings and selected product details, including prices, variants, reviews, and destination-specific shipping options shown for the displayed variant. - [Best Buy API](https://fous.com/workflows/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout. - [Idealista API](https://fous.com/workflows/idealista.md): Idealista provides homes for sale and rent in Spain, Italy and Portugal, plus current property listings and latest monthly asking prices per square metre for published areas. - [All Commerce workflows](https://fous.com/workflows/category/commerce)