{ "openapi": "3.0.1", "info": { "title": "Idealo API: Price Comparison & Shop Offers", "description": "Idealo scraper and idealo API alternative: products by search, EAN or link with lowest price, offer count, rating and specs, plus every shop's offer with total price, shipping and delivery. Germany, Austria, UK, France, Italy and Spain. Price comparison and price tracking.", "version": "0.1", "x-build-id": "uu0wCSErUUv2PxKhG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/firsthand~idealo-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-firsthand-idealo-api", "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/firsthand~idealo-api/runs": { "post": { "operationId": "runs-sync-firsthand-idealo-api", "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/firsthand~idealo-api/run-sync": { "post": { "operationId": "run-sync-firsthand-idealo-api", "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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Words you would type in the idealo search box, for example 'iphone 15' or 'kaffeemaschine'.", "items": { "type": "string" } }, "eans": { "title": "EAN / GTIN codes", "type": "array", "description": "Barcodes to look up. Each code returns the matching idealo product, with all shop offers if you turn them on.", "items": { "type": "string" } }, "startUrls": { "title": "idealo links or product ids", "type": "array", "description": "Product pages (https://www.idealo.de/preisvergleich/OffersOfProduct/...), category or search pages, or idealo product ids.", "items": { "type": "string" } }, "markets": { "title": "Countries", "type": "array", "description": "Which idealo sites to search. Queries and EANs run on each; links use their own site. Default Germany.", "items": { "type": "string", "enum": [ "de", "at", "uk", "fr", "it", "es" ], "enumTitles": [ "Germany (idealo.de)", "Austria (idealo.at)", "United Kingdom (idealo.co.uk)", "France (idealo.fr)", "Italy (idealo.it)", "Spain (idealo.es)" ] } }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Products in total across all queries, codes, links and countries. 100 if empty, 0 means no limit." }, "maxItemsPerQuery": { "title": "Max products per query", "minimum": 0, "type": "integer", "description": "Limit for each query or link in each country. Empty or 0 means no limit." }, "includeOffers": { "title": "Add every shop's offer", "type": "boolean", "description": "Each product gets the list of shops with price, total with shipping, delivery time and carrier, cheapest first, plus the lowest total price. Charged once per product." }, "maxOffersPerProduct": { "title": "Max offers per product", "minimum": 0, "type": "integer", "description": "Cheapest offers kept per product. Empty or 0 keeps all new-condition offers." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "idealo works without a proxy. Turn Apify Proxy on only if runs get refused." } } }, "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 } } } } } } } } } }