{ "openapi": "3.0.1", "info": { "title": "Kaufland Scraper — Slovak Products, Prices & Seller Contacts", "description": "Scrape products from the Kaufland.sk marketplace: names, prices (EUR), sellers, brands, EAN codes, ratings, images and categories, plus each seller's published contact details (email, phone, VAT id, legal name). Search by keyword, category or product URLs. No login, no cookies.", "version": "0.1", "x-build-id": "4lKH5BgkNkaGpqcLP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~kaufland-sk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-kaufland-sk-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/studio-amba~kaufland-sk-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-kaufland-sk-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/studio-amba~kaufland-sk-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-kaufland-sk-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search the Kaufland.sk marketplace (e.g., 'káva', 'notebook', 'slúchadlá'). Products are discovered by keyword and enriched with the full product data." }, "categoryId": { "title": "Category ID", "type": "integer", "description": "Optional. A numeric Kaufland category id to pull products for instead of a keyword search (e.g., 5921). Category ids appear in the 'category.id' field of any scraped product." }, "productUrls": { "title": "Product URLs", "maxItems": 1000, "type": "array", "description": "Optional. One or more Kaufland product URLs to scrape directly (https://www.kaufland.sk/product/400510966/), one per line. Up to 1000 URLs per run.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "fetchOffers": { "title": "Fetch all competing offers", "type": "boolean", "description": "Off by default. When off, each product row carries only the buy-box price and seller; the other sellers' offers are NOT included. Turn on to add `offers[]` with every competing offer on the product (price, shipping, delivery window, fulfilment type, seller). Adds about 1 extra request per product (1 per 100 offers), so runs take longer and cost more per product.", "default": false }, "fetchSellerDetails": { "title": "Fetch seller contact details (imprint)", "type": "boolean", "description": "Off by default. When off, `seller` is only the seller's display name. Turn on to add `sellerDetails` with the legal name, legal form, address, email, phone, VAT id and commercial-register data from the imprint each seller publishes on Kaufland (for the buy-box seller, and for every offer's seller when fetchOffers is also on). Adds 1 extra request per distinct seller; sellers are cached within a run. Fields a seller does not publish stay null.", "default": false }, "oneRowPerOffer": { "title": "One row per offer", "type": "boolean", "description": "Off by default (one row per product, with the competing offers nested in `offers[]`). Turn on to output one row per offer instead: the product fields plus a single `offer` object, and `sellerDetails` for that offer's seller when fetchSellerDetails is on. Implies fetchOffers. A product with no offers still produces one row with `offer: null`.", "default": false }, "maxOffersPerProduct": { "title": "Max offers per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on the number of competing offers collected per product when fetchOffers is on. Kaufland returns up to 100 offers per request.", "default": 100 }, "brightDataApiKey": { "title": "Bright Data API Key", "type": "string", "description": "Optional. Your own Bright Data Web Unlocker key. You do not need one: we supply the key and the actor runs without it. Set this only if you want Bright Data usage billed to your own account. Falls back to the BRIGHT_DATA_API_KEY environment variable." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Kaufland access itself goes through the Bright Data Web Unlocker; this proxy is used for any auxiliary requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SK" } } } }, "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 } } } } } } } } } }