SocialCrawl

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.

cURL
curl "https://www.socialcrawl.dev/v1/idealo/search?query=iphone%2015" \
  -H "x-api-key: YOUR_API_KEY"
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.

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"
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

2 endpoints available.

EndpointPathCredit Tier
Get an idealo Italy product with its shop offers/v1/idealo/productstandard (1cr)
Search idealo Italy price comparisons/v1/idealo/searchstandard (1cr)

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

PathRows per pageDate windowOne call collects
/v1/idealo/searchabout 34noneup 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

  • 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