{
  "openapi": "3.0.1",
  "info": {
    "title": "idealo Scraper – Prices, Shop Offers & EAN Lookup, 6 Countries",
    "description": "idealo scraper: search by product name, EAN barcode or link in 6 countries (DE, AT, FR, IT, ES, UK) and get every shop's offer: item price, shipping, total incl. shipping, delivery time and shop rating. Up to 20 offers per product included. Typical run: a 10-product search in about 5 seconds.",
    "version": "0.1",
    "x-build-id": "oKm4WyAIJtl9PKcDr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/apimy~idealo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-apimy-idealo-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/apimy~idealo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-apimy-idealo-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/apimy~idealo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-apimy-idealo-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "eans": {
            "title": "EAN / GTIN barcodes",
            "type": "array",
            "description": "8–14 digit barcodes (EAN-13, GTIN-14, UPC). Each one is matched to its idealo product page with all shop offers. A barcode idealo does not know comes back as a free \"not_found\" row.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "idealo product IDs",
            "type": "array",
            "description": "The number from an idealo product link, e.g. 203248697 from idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html.",
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "idealo links",
            "type": "array",
            "description": "Product pages, search or category result pages and shop pages from idealo.de, .at, .fr, .it, .es or .co.uk. The country is taken from the link itself.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search words",
            "type": "array",
            "description": "Free-text searches, exactly like the idealo search box (e.g. \"airpods pro 2\", \"dyson v15\"). Each result becomes a row; turn on \"Open every search result\" to get full product data and shop offers for each.",
            "items": {
              "type": "string"
            }
          },
          "shopIds": {
            "title": "Shop IDs",
            "type": "array",
            "description": "idealo shop IDs (the \"shopId\" field of any offer row, or the number in an idealo shop link). Returns the shop's address, country, rating, number of ratings and latest reviews.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "de",
              "at",
              "fr",
              "it",
              "es",
              "uk"
            ],
            "type": "string",
            "description": "Which idealo site barcodes, product IDs, search words and shop IDs are looked up on. Links always use their own country.",
            "default": "de"
          },
          "maxProductsPerSearch": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many results to take from each search word or search/category link (idealo shows 36 per page).",
            "default": 20
          },
          "maxSearchPages": {
            "title": "Max result pages per search",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Upper bound on result pages read per search (36 results each).",
            "default": 3
          },
          "openSearchResults": {
            "title": "Open every search result (full product + offers)",
            "type": "boolean",
            "description": "Off: one light row per result (title, lowest price, offer count, rating, best shop) at the search-result price. On: every product result is opened and delivered as a full product row with shop offers, at the product price.",
            "default": false
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Search results only: skip results whose lowest price is below this (in the site currency)."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Search results only: skip results whose lowest price is above this."
          },
          "includeOffers": {
            "title": "Include shop offers",
            "type": "boolean",
            "description": "Every shop offer with price, shipping cost, total price, delivery time, carriers, payment methods, shop rating and a click-out link.",
            "default": true
          },
          "maxOffersPerProduct": {
            "title": "Max offers per product",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "The first 20 offers are included in the product price. Each offer above 20 is charged as \"extra offer\" (see Pricing).",
            "default": 20
          },
          "offersOutput": {
            "title": "Offers output",
            "enum": [
              "nested",
              "rows"
            ],
            "type": "string",
            "description": "Nested keeps one row per product. Rows writes the product row plus one row per shop offer with the product ID, title and GTIN repeated — same price either way.",
            "default": "nested"
          },
          "minShopRating": {
            "title": "Min shop rating",
            "enum": [
              "0",
              "3",
              "3.5",
              "4",
              "4.5"
            ],
            "type": "string",
            "description": "Keep only offers from shops rated at least this on idealo (1–5).",
            "default": "0"
          },
          "minShopReviews": {
            "title": "Min number of shop ratings",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only offers from shops with at least this many idealo ratings.",
            "default": 0
          },
          "onlyFreeShipping": {
            "title": "Only offers with free shipping",
            "type": "boolean",
            "description": "Drop offers where the total price is higher than the item price.",
            "default": false
          },
          "excludeMarketplaces": {
            "title": "Exclude marketplace sellers",
            "type": "boolean",
            "description": "Drop offers sold through marketplaces (eBay, Kaufland, Amazon Marketplace and the like).",
            "default": false
          },
          "excludeUsed": {
            "title": "Exclude used / refurbished",
            "type": "boolean",
            "description": "Drop offers whose title says used or refurbished.",
            "default": false
          },
          "shopCountries": {
            "title": "Shop countries",
            "type": "array",
            "description": "Keep only offers from shops registered in these countries (2-letter codes: DE, AT, FR, IT, ES, GB, NL…). Reads each shop's address once per run — a little slower.",
            "items": {
              "type": "string"
            }
          },
          "priceWatchStore": {
            "title": "Price watch name",
            "type": "string",
            "description": "Any name, e.g. \"my-idealo-watch\". The Actor remembers the last lowest price, offer count and each shop's total price under this name and adds previousLowestPrice, priceChange, priceChangePct and priceChangeType to every product row."
          },
          "onlyPriceChanges": {
            "title": "Only products whose price changed",
            "type": "boolean",
            "description": "With a price watch name: skip (and do not charge) products whose lowest price, offer count and shop prices are all the same as last time. New products always come through.",
            "default": true
          },
          "onlyNewRowsStore": {
            "title": "Only new products (memory name)",
            "type": "string",
            "description": "Any name, e.g. \"new-idealo-products\". Products already delivered under this name in earlier runs are skipped and not charged. Good for \"new listings in a category\"."
          },
          "includeSpecifications": {
            "title": "Include specifications",
            "type": "boolean",
            "description": "The full idealo data sheet (section, name, value), e.g. display size, energy class, release year.",
            "default": true
          },
          "includeVariants": {
            "title": "Include variants",
            "type": "boolean",
            "description": "Other colours / sizes / storage versions of the same product (ProductGroup) with their idealo IDs, GTINs and links.",
            "default": true
          },
          "includeUserReviews": {
            "title": "Include latest user reviews",
            "type": "boolean",
            "description": "The latest user reviews idealo shows on the product page (author, date, stars, text).",
            "default": false
          },
          "maxConcurrency": {
            "title": "Parallel pages",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many products are read at the same time.",
            "default": 4
          },
          "includeRunSummary": {
            "title": "Add a free summary row",
            "type": "boolean",
            "description": "One free row at the end: rows delivered, events charged and their cost on your plan.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}