{ "openapi": "3.0.1", "info": { "title": "Geizhals Price Comparison Scraper", "description": "[💰 $1.0 / 1K] Scrape Geizhals (geizhals.de / .at / .eu) by keyword or URL. Get product names, brands, best prices, ratings, specifications and every merchant offer (shop, price, shipping, availability) from the leading DACH price-comparison platform.", "version": "1.0", "x-build-id": "nP9tVE6RdyKqbWlFU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~geizhals-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-geizhals-de-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/solidcode~geizhals-de-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-geizhals-de-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/solidcode~geizhals-de-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-geizhals-de-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": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "Type plain keywords to search Geizhals for, such as 'grafikkarte', 'ssd 1tb' or 'kaffeevollautomat'. We build the search for you — no need to create URLs. Add as many terms as you like.", "items": { "type": "string" } }, "startUrls": { "title": "Geizhals URLs", "type": "array", "description": "Paste Geizhals links directly: category pages, search-result pages, or individual product pages. The type is detected automatically. Use this if you already have the exact pages you want.", "items": { "type": "string" } }, "domain": { "title": "Store", "enum": [ "geizhals.de", "geizhals.at", "geizhals.eu" ], "type": "string", "description": "Which Geizhals store to use. This sets the prices, available merchants and the language: Germany (geizhals.de), Austria (geizhals.at) or International (geizhals.eu).", "default": "geizhals.de" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of products to return in total, across all search terms and URLs. Set to 0 to collect everything available. Products are collected a full page (about 30) at a time, so the final count is rounded up to the end of the last page — asking for 15 may return 30. Every returned product is billed. Tip: start with 20-100 to test, then increase.", "default": 100 }, "includeOffers": { "title": "Include all merchant offers & full specifications", "type": "boolean", "description": "When on, every product that has competing shop offers is enriched with its full merchant list (shop name, price, shipping, total price, availability), the complete specifications, and a product description. We return every offer such a product currently has, up to a safety limit of about 1,000 offers per product. Products with no offers — such as variant overview pages that just group related models — are returned as price summaries (name, brand, best price, offer count, rating). This is slower and returns much more data. When off, you get the product summary and the best (lowest) price only.", "default": false }, "minPrice": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only return products priced at or above this amount, in euros. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only return products priced at or below this amount, in euros. Leave empty for no maximum." } } }, "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 } } }, "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 } } } } } } } } } }