100 free credits. No credit card required.Start building
Logo
idealo logoidealo API

Get idealo Italy shop prices and offers with one API

Read any idealo Italy product with every listed shop offer, its exact euro price, delivery note and link, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

idealo logo
/v1/idealo

2 active endpoints. Product search and product detail with the shops' offers.

  • GET /v1/idealo/search
  • GET /v1/idealo/product

What idealo endpoints does SocialCrawl ship?

Two read endpoints for idealo Italy price comparison: search products by keyword, and read one product with the shops that sell it.

/v1/idealo/search

idealo Italy products for a keyword, about 30 a page, with idealo's total: the product id, name, idealo link, image, the lowest price in euros and how many shop offers idealo compares. Standard tier (1 credit).

query, page, country

/v1/idealo/product

One idealo Italy product by its idealo.it link: name, brand, image, stock, the lowest price in euros, idealo's offer count and each listed offer's shop, exact price, delivery note and link. Standard tier (1 credit).

url, country

idealo Italy API2 endpoints supported
View docs
Products

Returns idealo Italy products for a keyword search with the lowest price in euros and how many shops offer each.

Use it to compare Italian market prices for a product type, Italy only.

1 credit

GET/v1/idealo/search?query=iphone+15

query · Product keywords, 1 to 200 characters, for example iphone 15.

$ curl https://www.socialcrawl.dev/v1/idealo/search?query=iphone+15 \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the idealo API works

idealo is a normal SocialCrawl data surface. You call GET /v1/idealo/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No idealo account is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes query and the cursor. Product takes url, the product's idealo.it link. Both take country, which is IT only. Formats are validated before any charge.

Pay in credits, not seats

Both idealo routes cost 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.

The usual integration chain

Most products search for the items they follow, then read each product as often as they track its prices.

01Search products
GET /v1/idealo/search?query=…

ProductList with the lowest price and the offer count

Every row carries the product's idealo link, which the product read takes.

02Read the product
GET /v1/idealo/product?url=…

Product with the lowest price, offer count and shop offers

Every offer names its shop and exact euro price, so a schedule can follow each shop's price over time.

request
GET /v1/idealo/product?url=https%3A%2F%2Fwww.idealo.it%2Fconfronta-prezzi%2F203235721%2Fapple-iphone-15.html
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "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?…"
            }
          ]
        }
      }
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

ProductListsearch

items[] with id, title, url, image_urls, price in EUR, ext.idealo.offer_count; total and next_cursor

Productproduct

title, brand, image_urls, availability, price in EUR, ext.idealo with offer_count and offers[] (seller, price, currency, delivery, url)

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. idealo is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the idealo route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public data is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    idealo data is mapped to the Product archetype with the idealo-only facts in product.ext.idealo, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search and product: 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Search: about 30 products a page
  • A country other than IT, or a link from another site: 400, never charged
  • Italy (idealo.it) only
  • No orders, accounts or price alerts

How SocialCrawl gets idealo data

idealo's comparison pages are public. We normalize them into the SocialCrawl schema so your code does not learn a second vendor SDK.

What idealo is for this API

idealo Italy's price comparison pages: keyword search results, and one product with the shops that sell it and each shop's price.

How SocialCrawl reaches it

Public comparison pages are read on request and normalized server-side. You never run an idealo login or integration.

What leaves our edge

ProductList for a search and Product for one item, the shared commerce shape. The idealo-only facts, the offer count and the offers, sit in product.ext.idealo.

What we do not ship live

No orders, accounts, price alerts or data behind a login.

field map sketch
idealo product→ product.*product id, name, brand, image, stock
lowest price→ product.pricelowest price in euros
offer count, shop offers→ product.ext.idealooffer count and each shop's offer

What this API is used for

The jobs this API is most often used for.

2active idealo endpoints in the registry
1credit per call on every idealo route

Italian price comparison and shop price monitoring

Callers keep the idealo links of the products they follow and read them on a schedule. Every listed idealo Italy shop offer with its exact euro price, from one key in the shared Product schema.

Live misses read the public comparison page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Shop price monitoring

Python, scheduled jobs

read a product on a schedule to record each shop's price and delivery note.

Market pricing research

Python, notebooks

compare how many Italian shops sell a product and how far their prices spread.

Competitor pricing

Node, webhooks

flag when another shop undercuts your price on a product you sell.

How to call the idealo API

Both idealo routes are 1 credit. Cache hits are free.

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

Same key as the rest of the catalog

Endpoints

What data does the idealo Italy API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl idealo API cover?
It covers Search and Product: one idealo Italy product with the lowest price in euros, how many shop offers idealo compares, and each offer's shop, exact price, delivery note and link, in the same unified JSON as the other 94 platforms.
Which countries does the idealo API cover?
Italy (idealo.it) only. country takes IT alone; any other value answers 400 and is not charged.
Do I need an idealo account?
No. You call SocialCrawl with one SocialCrawl API key, so there is no idealo login to manage.
Why are fewer offers listed than offer_count?
offer_count is idealo's own count of offers for the product. The record lists the leading offers, lowest price first, so the list can be shorter.
Is there a product description?
No. idealo's page text summarises the comparison rather than describing the product, so product.description is null.
How much does the idealo API cost?
Each call costs 1 credit and cache hits are free. A new account gets 100 free credits with no card.
Is scraping idealo Italy data legal?
SocialCrawl returns publicly available idealo Italy data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with idealo Italy's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
idealo Italy scraping API vs the official idealo Italy API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call idealo Italy endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the idealo Italy API reference in the docs

🤖 AI agent or LLM? Read this page as markdown