Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

Skip to content
← All documentation

// Idealo Italy documentation

Idealo Italy Search API

Search Idealo Italy products with prices and product links.

GET / POST https://api.litescrape.com/api/idealo/search

For background execution, use POST /api/idealo/search/async. Learn how to submit and poll async requests →

// from request to code

Integrate Idealo Italy Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIIdealo Italy Search
More options 1
Request parameters

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/idealo/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "iphone",
  "page": 1
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/idealo/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "q": "iphone",
  "page": 1
}

Continue a product search

Repeat the same search query with page set to pagination.next_page. Stop when next_page is null. Each response contains one page of results.

Product prices and offers

Prices are in EUR. A product's price is its listed price or the lowest listed offer for grouped products; delivery charges and seller conditions may differ.

// request reference

Idealo Italy Search parameters

Send query parameters with GET /api/idealo/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

q
Search queryRequired

Product keywords to search for.

Type string · GET query or POST JSON

Example / input hint: iphone

  • Minimum characters: 2
  • Maximum characters: 200
page
PageOptional

Result page, starting at one.

Type integer · GET query or POST JSON · Default 1

Example / input hint: 1

  • Minimum: 1
  • Maximum: 100

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_parameters, products, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "products": [
    {
      "product_id": "207643424",
      "title": "Apple iPhone 17",
      "url": "https://www.idealo.it/confronta-prezzi/207643424/apple-iphone-17.html",
      "image": "https://cdn.idealo.com/folder/Product/207643/4/207643424/s10_produktbild_mittelgross/apple-iphone-17.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 834.7,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 351,
      "offers": []
    },
    {
      "product_id": "207644441",
      "title": "Apple iPhone 17 Pro",
      "url": "https://www.idealo.it/confronta-prezzi/207644441/apple-iphone-17-pro.html",
      "image": "https://cdn.idealo.com/folder/Product/207644/4/207644441/s10_produktbild_mittelgross/apple-iphone-17-pro.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1054.24,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 246,
      "offers": []
    },
    {
      "product_id": "213922528",
      "title": "Apple iPhone 18 Pro",
      "url": "https://www.idealo.it/confronta-prezzi/213922528/apple-iphone-18-pro.html",
      "image": "https://cdn.idealo.com/folder/Product/213922/5/213922528/s10_produktbild_mittelgross/apple-iphone-18-pro.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1229.22,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 298,
      "offers": []
    },
    {
      "product_id": "204736899",
      "title": "Apple iPhone 16",
      "url": "https://www.idealo.it/confronta-prezzi/204736899/apple-iphone-16.html",
      "image": "https://cdn.idealo.com/folder/Product/204736/8/204736899/s10_produktbild_mittelgross/apple-iphone-16.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 689.9,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 279,
      "offers": []
    },
    {
      "product_id": "207645183",
      "title": "Apple iPhone 17 Pro Max",
      "url": "https://www.idealo.it/confronta-prezzi/207645183/apple-iphone-17-pro-max.html",
      "image": "https://cdn.idealo.com/folder/Product/207645/1/207645183/s10_produktbild_mittelgross/apple-iphone-17-pro-max.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1122.24,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 314,
      "offers": []
    },
    {
      "product_id": "207645214",
      "title": "Apple iPhone Air",
      "url": "https://www.idealo.it/confronta-prezzi/207645214/apple-iphone-air.html",
      "image": "https://cdn.idealo.com/folder/Product/207645/2/207645214/s10_produktbild_mittelgross/apple-iphone-air.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 788,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 262,
      "offers": []
    },
    {
      "product_id": "203235721",
      "title": "Apple iPhone 15",
      "url": "https://www.idealo.it/confronta-prezzi/203235721/apple-iphone-15.html",
      "image": "https://cdn.idealo.com/folder/Product/203235/7/203235721/s10_produktbild_mittelgross/apple-iphone-15.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 571.9,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 209,
      "offers": []
    },
    {
      "product_id": "207673491",
      "title": "Apple iPhone 17 256GB Black",
      "url": "https://www.idealo.it/confronta-prezzi/207673491/apple-iphone-17-256gb-black.html",
      "image": "https://cdn.idealo.com/folder/Product/207673/4/207673491/s10_produktbild_mittelgross/apple-iphone-17-256gb-black.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 834.7,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 43,
      "offers": []
    },
    {
      "product_id": "203235577",
      "title": "Apple iPhone 15 Pro",
      "url": "https://www.idealo.it/confronta-prezzi/203235577/apple-iphone-15-pro.html",
      "image": "https://cdn.idealo.com/folder/Product/203235/5/203235577/s10_produktbild_mittelgross/apple-iphone-15-pro.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 729.99,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 167,
      "offers": []
    },
    {
      "product_id": "209556232",
      "title": "Apple iPhone 17e",
      "url": "https://www.idealo.it/confronta-prezzi/209556232/apple-iphone-17e.html",
      "image": "https://cdn.idealo.com/folder/Product/209556/2/209556232/s10_produktbild_mittelgross/apple-iphone-17e.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 725,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 102,
      "offers": []
    },
    {
      "product_id": "202079048",
      "title": "Apple iPhone 14 Plus",
      "url": "https://www.idealo.it/confronta-prezzi/202079048/apple-iphone-14-plus.html",
      "image": "https://cdn.idealo.com/folder/Product/202079/0/202079048/s10_produktbild_mittelgross/apple-iphone-14-plus.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 399.99,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 179,
      "offers": []
    },
    {
      "product_id": "213920701",
      "title": "Apple iPhone 18 Pro Max",
      "url": "https://www.idealo.it/confronta-prezzi/213920701/apple-iphone-18-pro-max.html",
      "image": "https://cdn.idealo.com/folder/Product/213920/7/213920701/s10_produktbild_mittelgross/apple-iphone-18-pro-max.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1429.9,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 261,
      "offers": []
    },
    {
      "product_id": "202069622",
      "title": "Apple iPhone 14 Pro",
      "url": "https://www.idealo.it/confronta-prezzi/202069622/apple-iphone-14-pro.html",
      "image": "https://cdn.idealo.com/folder/Product/202069/6/202069622/s10_produktbild_mittelgross/apple-iphone-14-pro.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 498.99,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 160,
      "offers": []
    },
    {
      "product_id": "204736911",
      "title": "Apple iPhone 16 Pro",
      "url": "https://www.idealo.it/confronta-prezzi/204736911/apple-iphone-16-pro.html",
      "image": "https://cdn.idealo.com/folder/Product/204736/9/204736911/s10_produktbild_mittelgross/apple-iphone-16-pro.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1113.89,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 165,
      "offers": []
    },
    {
      "product_id": "207702131",
      "title": "Apple iPhone 17 256GB Mist Blue",
      "url": "https://www.idealo.it/confronta-prezzi/207702131/apple-iphone-17-256gb-mist-blue.html",
      "image": "https://cdn.idealo.com/folder/Product/207702/1/207702131/s10_produktbild_mittelgross/apple-iphone-17-256gb-mist-blue.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 854,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 50,
      "offers": []
    },
    {
      "product_id": "207674129",
      "title": "Apple iPhone 17 Pro 256GB Deep Blue",
      "url": "https://www.idealo.it/confronta-prezzi/207674129/apple-iphone-17-pro-256gb-deep-blue.html",
      "image": "https://cdn.idealo.com/folder/Product/207674/1/207674129/s10_produktbild_mittelgross/apple-iphone-17-pro-256gb-deep-blue.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1109,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 24,
      "offers": []
    },
    {
      "product_id": "205852471",
      "title": "Apple iPhone 16e",
      "url": "https://www.idealo.it/confronta-prezzi/205852471/apple-iphone-16e.html",
      "image": "https://cdn.idealo.com/folder/Product/205852/4/205852471/s10_produktbild_mittelgross/apple-iphone-16e.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 609,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 109,
      "offers": []
    },
    {
      "product_id": "207702133",
      "title": "Apple iPhone 17 256GB Sage",
      "url": "https://www.idealo.it/confronta-prezzi/207702133/apple-iphone-17-256gb-sage.html",
      "image": "https://cdn.idealo.com/folder/Product/207702/1/207702133/s10_produktbild_mittelgross/apple-iphone-17-256gb-sage.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 854,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 48,
      "offers": []
    },
    {
      "product_id": "207702129",
      "title": "Apple iPhone 17 256GB Lavender",
      "url": "https://www.idealo.it/confronta-prezzi/207702129/apple-iphone-17-256gb-lavender.html",
      "image": "https://cdn.idealo.com/folder/Product/207702/1/207702129/s10_produktbild_mittelgross/apple-iphone-17-256gb-lavender.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 834.7,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 58,
      "offers": []
    },
    {
      "product_id": "207673484",
      "title": "Apple iPhone 17 Pro 256GB Silver",
      "url": "https://www.idealo.it/confronta-prezzi/207673484/apple-iphone-17-pro-256gb-silver.html",
      "image": "https://cdn.idealo.com/folder/Product/207673/4/207673484/s10_produktbild_mittelgross/apple-iphone-17-pro-256gb-silver.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1096.56,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 27,
      "offers": []
    },
    {
      "product_id": "203248697",
      "title": "Apple iPhone 15 128GB Blue",
      "url": "https://www.idealo.it/confronta-prezzi/203248697/apple-iphone-15-128gb-blue.html",
      "image": "https://cdn.idealo.com/folder/Product/203248/6/203248697/s10_produktbild_mittelgross/apple-iphone-15-128gb-blue.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 571.9,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 28,
      "offers": []
    },
    {
      "product_id": "207673474",
      "title": "Apple iPhone 17 Pro 256GB Cosmic Orange",
      "url": "https://www.idealo.it/confronta-prezzi/207673474/apple-iphone-17-pro-256gb-cosmic-orange.html",
      "image": "https://cdn.idealo.com/folder/Product/207673/4/207673474/s10_produktbild_mittelgross/apple-iphone-17-pro-256gb-cosmic-orange.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1054.24,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 43,
      "offers": []
    },
    {
      "product_id": "209556273",
      "title": "Apple iPhone 17e 256GB White",
      "url": "https://www.idealo.it/confronta-prezzi/209556273/apple-iphone-17e-256gb-white.html",
      "image": "https://cdn.idealo.com/folder/Product/209556/2/209556273/s10_produktbild_mittelgross/apple-iphone-17e-256gb-white.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 725,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 25,
      "offers": []
    },
    {
      "product_id": "207673482",
      "title": "Apple iPhone 17 Pro Max 256GB Cosmic Orange",
      "url": "https://www.idealo.it/confronta-prezzi/207673482/apple-iphone-17-pro-max-256gb-cosmic-orange.html",
      "image": "https://cdn.idealo.com/folder/Product/207673/4/207673482/s10_produktbild_mittelgross/apple-iphone-17-pro-max-256gb-cosmic-orange.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1122.24,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 46,
      "offers": []
    },
    {
      "product_id": "207702174",
      "title": "Apple iPhone Air 256GB Sky Blue",
      "url": "https://www.idealo.it/confronta-prezzi/207702174/apple-iphone-air-256gb-sky-blue.html",
      "image": "https://cdn.idealo.com/folder/Product/207702/1/207702174/s10_produktbild_mittelgross/apple-iphone-air-256gb-sky-blue.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 788,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 31,
      "offers": []
    },
    {
      "product_id": "207673478",
      "title": "Apple iPhone 17 256GB White",
      "url": "https://www.idealo.it/confronta-prezzi/207673478/apple-iphone-17-256gb-white.html",
      "image": "https://cdn.idealo.com/folder/Product/207673/4/207673478/s10_produktbild_mittelgross/apple-iphone-17-256gb-white.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 834.7,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 43,
      "offers": []
    },
    {
      "product_id": "214023686",
      "title": "Apple iPhone 18 Pro 256GB Nero",
      "url": "https://www.idealo.it/confronta-prezzi/214023686/apple-iphone-18-pro-256gb-nero.html",
      "image": "https://cdn.idealo.com/folder/Product/214023/6/214023686/s10_produktbild_mittelgross/apple-iphone-18-pro-256gb-nero.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1259,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 22,
      "offers": []
    },
    {
      "product_id": "203248026",
      "title": "Apple iPhone 15 512GB Green",
      "url": "https://www.idealo.it/confronta-prezzi/203248026/apple-iphone-15-512gb-green.html",
      "image": "https://cdn.idealo.com/folder/Product/203248/0/203248026/s10_produktbild_mittelgross/apple-iphone-15-512gb-green.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 749,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 10,
      "offers": []
    },
    {
      "product_id": "209556277",
      "title": "Apple iPhone 17e 256GB Black",
      "url": "https://www.idealo.it/confronta-prezzi/209556277/apple-iphone-17e-256gb-black.html",
      "image": "https://cdn.idealo.com/folder/Product/209556/2/209556277/s10_produktbild_mittelgross/apple-iphone-17e-256gb-black.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 729,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 22,
      "offers": []
    },
    {
      "product_id": "214023712",
      "title": "Apple iPhone 18 Pro 256GB Ghiacciaio",
      "url": "https://www.idealo.it/confronta-prezzi/214023712/apple-iphone-18-pro-256gb-ghiacciaio.html",
      "image": "https://cdn.idealo.com/folder/Product/214023/7/214023712/s10_produktbild_mittelgross/apple-iphone-18-pro-256gb-glacier.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1229.22,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 31,
      "offers": []
    },
    {
      "product_id": "207674124",
      "title": "Apple iPhone Air 256GB Space Black",
      "url": "https://www.idealo.it/confronta-prezzi/207674124/apple-iphone-air-256gb-space-black.html",
      "image": "https://cdn.idealo.com/folder/Product/207674/1/207674124/s10_produktbild_mittelgross/apple-iphone-air-256gb-space-black.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 808,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 30,
      "offers": []
    },
    {
      "product_id": "203235629",
      "title": "Apple iPhone 15 Plus",
      "url": "https://www.idealo.it/confronta-prezzi/203235629/apple-iphone-15-plus.html",
      "image": "https://cdn.idealo.com/folder/Product/203235/6/203235629/s10_produktbild_mittelgross/apple-iphone-15-plus.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 629.91,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 156,
      "offers": []
    },
    {
      "product_id": "209556275",
      "title": "Apple iPhone 17e 256GB Soft Pink",
      "url": "https://www.idealo.it/confronta-prezzi/209556275/apple-iphone-17e-256gb-soft-pink.html",
      "image": "https://cdn.idealo.com/folder/Product/209556/2/209556275/s10_produktbild_mittelgross/apple-iphone-17e-256gb-soft-pink.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 725,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 24,
      "offers": []
    },
    {
      "product_id": "207674128",
      "title": "Apple iPhone 17 Pro Max 256GB Deep Blue",
      "url": "https://www.idealo.it/confronta-prezzi/207674128/apple-iphone-17-pro-max-256gb-deep-blue.html",
      "image": "https://cdn.idealo.com/folder/Product/207674/1/207674128/s10_produktbild_mittelgross/apple-iphone-17-pro-max-256gb-deep-blue.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 1169,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 41,
      "offers": []
    },
    {
      "product_id": "203247729",
      "title": "Apple iPhone 15 Pro 256GB Black Titanium",
      "url": "https://www.idealo.it/confronta-prezzi/203247729/apple-iphone-15-pro-256gb-black-titanium.html",
      "image": "https://cdn.idealo.com/folder/Product/203247/7/203247729/s10_produktbild_mittelgross/apple-iphone-15-pro-256gb-black-titanium.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 729.99,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 14,
      "offers": []
    },
    {
      "product_id": "201438991",
      "title": "Apple iPhone 13 mini",
      "url": "https://www.idealo.it/confronta-prezzi/201438991/apple-iphone-13-mini.html",
      "image": "https://cdn.idealo.com/folder/Product/201438/9/201438991/s10_produktbild_mittelgross/apple-iphone-13-mini.jpg",
      "brand": null,
      "description": null,
      "price": {
        "amount": 389,
        "currency": "EUR"
      },
      "availability": null,
      "offer_count": 142,
      "offers": []
    }
  ],
  "pagination": {
    "current": 1,
    "next_page": 2,
    "total_results": 632
  },
  "search_parameters": {
    "q": "iphone",
    "page": 1
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More Idealo Italy APIs