# idealo (/docs/idealo) Compare Italian shop prices on idealo, then read one product with every shop's offer idealo is a price comparison site. These endpoints cover idealo Italy (idealo.it) only: they search its products by keyword and read one product with the shops that sell it. Each search row carries the lowest price in euros and how many shop offers idealo compares; the product record adds the offers themselves, each with the shop, its exact price, its delivery note and idealo's link to the offer. Every result uses the canonical `Product` shape, and the idealo-only facts sit in `product.ext.idealo`. Base URL: `/v1/idealo/...` idealo exposes 2 routes here. ## Quickstart ### Search products Pass product keywords as `query`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/idealo/search?query=iphone%2015" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "product": { "id": "203235721", "title": "Apple iPhone 15", "url": "https://www.idealo.it/confronta-prezzi/203235721/apple-iphone-15.html", "price": { "current": 573.93, "original": null, "currency": "EUR" }, "ext": { "idealo": { "offer_count": 183, "offers": null } } } } ], "total": 472 } } ``` ### Read one product with its offers Take `product.url` from a search row and pass it as `url`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/idealo/product?url=https%3A%2F%2Fwww.idealo.it%2Fconfronta-prezzi%2F203235721%2Fapple-iphone-15.html" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "product": { "id": "203235721", "title": "Apple iPhone 15", "brand": "Apple", "price": { "current": 573.93, "original": null, "currency": "EUR" }, "availability": "In stock", "ext": { "idealo": { "offer_count": 56, "offers": [ { "seller": "amicoemporio.it", "price": 573.93, "currency": "EUR", "delivery": "Consegna: fino a mar 01.12.", "url": "https://www.idealo.it/relocator/relocate?..." } ] } } } } } ``` ## Questions people ask ### Which countries does it cover? Italy only. `country` takes `IT` alone; any other value answers `400` and is not charged. ### Why are fewer offers listed than `offer_count`? `offer_count` is idealo's own count of offers for the product. The product page lists the leading offers, lowest price first, so the list can be shorter than the count. ### Is there a product description? No. idealo's page text is a summary of the comparison, not the product's own description, so `product.description` is null. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/idealo/search` | about 34 | none | up to 5,000 rows or 50 pages | **Country and region** `country` and `region` do different jobs on different endpoints. Each line below says what the parameter does there. [How they differ](/docs/data-availability.md#country-and-region). - `country` on `/v1/idealo/product`, `/v1/idealo/search`: Marketplace. idealo is covered for Italy (idealo.it) only, so the one value is IT, the default. ## Platform notes **Prices are in euros, exactly as listed.** A price idealo shows only as text is null rather than a guessed number. **Page sizes vary.** A search page holds about 30 products; pass the returned cursor until none comes back. ## Next steps - [Errors](/docs/errors.md): What each status means and which ones are refunded. - [Pagination](/docs/pagination.md): How list endpoints page.