{
"openapi": "3.0.1",
"info": {
"title": "Idealo Scraper API - Preisvergleich, Angebote & Specs",
"description": "🛒 Scrape idealo products by keyword or URL on 6 country sites (DE, AT, UK, FR, IT, ES). Get the best price, every shop offer with shipping and availability, specs, ratings, reviews count and the daily price history, as clean structured data. No login, no browser. Pay per result.",
"version": "0.1",
"x-build-id": "2LkgWZScU8fmEf2vP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapifier~idealo-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapifier-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/scrapifier~idealo-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapifier-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/scrapifier~idealo-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapifier-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": {
"queries": {
"title": "Search keywords",
"type": "array",
"description": "Products to search for, one keyword per line (e.g. iphone 15, lego star wars, a brand, a model or an EAN). Each keyword becomes one search on the selected country site.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "idealo URLs to scrape directly: a search results page, a category page (with or without filters), or a product page. Product pages always return the full list of shop offers.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"country": {
"title": "Country site",
"enum": [
"de",
"at",
"uk",
"fr",
"it",
"es"
],
"type": "string",
"description": "Which idealo country site to search on. Pasted URLs keep their own country automatically.",
"default": "de"
},
"sort": {
"title": "Sort order",
"enum": [
"RELEVANCE",
"PRICE_ASC",
"PRICE_DESC",
"DISCOUNT_DESC",
"CREATION_DATE_DESC"
],
"type": "string",
"description": "How to order search results before the cap is applied.",
"default": "RELEVANCE"
},
"excludeUsed": {
"title": "Exclude used products",
"type": "boolean",
"description": "Only return new products (skip refurbished and second-hand listings).",
"default": false
},
"minPrice": {
"title": "Minimum price",
"minimum": 1,
"type": "integer",
"description": "Only keep products whose best price is at or above this value (in the site currency)."
},
"maxPrice": {
"title": "Maximum price",
"minimum": 1,
"type": "integer",
"description": "Only keep products whose best price is at or below this value (in the site currency)."
},
"maxItems": {
"title": "Max products (total)",
"minimum": 1,
"type": "integer",
"description": "Hard cap on the total number of products across all searches and URLs. You pay per result, so this is also your cost cap.",
"default": 100
},
"maxItemsPerQuery": {
"title": "Max products per search",
"minimum": 1,
"type": "integer",
"description": "Optional cap per individual keyword or URL. Leave empty to only use the total cap."
},
"includeOffers": {
"title": "Include all shop offers",
"type": "boolean",
"description": "Visit each product page and attach the full price comparison list: every shop, its price, shipping cost, delivery estimate and payment methods. Slower, but this is the core idealo data.",
"default": false
},
"maxOffersPerProduct": {
"title": "Max offers per product",
"minimum": 1,
"type": "integer",
"description": "Cap the number of shop offers attached to each product.",
"default": 40
},
"includeSpecs": {
"title": "Include technical specifications",
"type": "boolean",
"description": "Attach the full technical datasheet of each product (grouped by section, e.g. Display, Battery, Hardware).",
"default": false
},
"includePriceHistory": {
"title": "Include price history",
"type": "boolean",
"description": "Attach the daily best-price history of each product with statistics (average, lowest, highest price over the period).",
"default": false
},
"priceHistoryPeriod": {
"title": "Price history period",
"enum": [
"1M",
"3M",
"6M",
"1Y"
],
"type": "string",
"description": "How far back the price history goes.",
"default": "3M"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. Apify Proxy (automatic) works well; switch to residential proxies if you see blocked runs.",
"default": {
"useApifyProxy": true
}
},
"verbose": {
"title": "Verbose logging",
"type": "boolean",
"description": "Log progress details for every search.",
"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
}
}
}
}
}
}
}
}
}
}