{ "openapi": "3.0.1", "info": { "title": "Kaufland Seller Contact Scraper — Emails, Phone, VAT", "description": "Turn any Kaufland search, product or shop URL into a lead list of the third-party sellers — legal name, address, VAT, phone and email from the impressum. Germany, Austria, Czechia, Slovakia, Poland, France and Italy. Every offer, not just the buy-box. Pure HTTP. JSON/CSV.", "version": "1.0", "x-build-id": "aa8gpfsNouwg1Kp58" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~kaufland-sellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-kaufland-sellers-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/memo23~kaufland-sellers-scraper/runs": { "post": { "operationId": "runs-sync-memo23-kaufland-sellers-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/memo23~kaufland-sellers-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-kaufland-sellers-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": { "searchQueries": { "title": "🔍 Search queries", "type": "array", "description": "Keywords or brand names to search. Each keyword runs on the storefront selected in country (default de). The unique sellers behind the returned products are then scraped. Valid values: non-empty strings. Example: [\"cosrx\", \"phone case\"]. Default: none (use startUrls instead).", "items": { "type": "string" } }, "startUrls": { "title": "📎 Start URLs (optional)", "type": "array", "description": "Direct Kaufland URLs, mixed freely with search queries. Host picks the country: kaufland.de, .at, .cz, .sk, .pl, .fr or .it. Accepted: search (/s/?search_value=…), product (/product/{id}/), shop (/shops/{name}/) or impressum (/shops/{name}/profile/?id_seller=…). Other hosts are skipped. Example: [{\"url\":\"https://www.kaufland.de/product/407375906/\"}]. Default: empty.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "🌍 Marketplace countries", "type": "array", "description": "Which Kaufland storefronts the search queries run on. Pick one or more — each query is scraped on every selected country in the same run, so [\"cosrx\"] on [de, at] is two searches. Start URLs ignore this — their country is taken from the URL host. Valid: de, at, cz, sk, pl, fr, it. Default: [\"de\"].", "items": { "type": "string", "enum": [ "de", "at", "cz", "sk", "pl", "fr", "it" ], "enumTitles": [ "Germany (kaufland.de)", "Austria (kaufland.at)", "Czechia (kaufland.cz)", "Slovakia (kaufland.sk)", "Poland (kaufland.pl)", "France (kaufland.fr)", "Italy (kaufland.it)" ] } }, "maxItems": { "title": "Max sellers per search / URL", "minimum": 1, "type": "integer", "description": "Maximum unique sellers to scrape for EACH search query, per country, or each start URL. One query on two countries with this set to 50 returns up to 100 sellers total. The actor auto-inspects enough products per search to reach this number, and each product contributes every competing seller (not just the buy-box). Total spend is still bounded by the run's max-charge limit (and a free-tier cap for free users). Valid: integer ≥ 1. Example: 50. Prefill: 50." }, "enrichEmails": { "title": "💌 Enrich missing emails (opt-in)", "type": "boolean", "description": "When true, sellers whose Kaufland impressum has no email are resolved by legal business name to a company website and that site is scanned for contact emails. Best-effort; adds latency. Emails already published on Kaufland stay on the row and are never billed as enrichment. Valid: true / false. Default: false.", "default": false }, "qualifyByPayment": { "title": "💳 Qualify by payment (flag businesses that take money online)", "type": "boolean", "description": "Requires enrichEmails=true. Reuses the pages already fetched for email discovery and looks for payment processors / e-commerce platforms. Adds takesPayments, paymentProcessors, stripeLiveKey and paymentConfidence. Valid: true / false. Default: false.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages / API calls to fetch in parallel. Automatically clamped to what the run's memory can safely hold — raise memory to go faster. Valid: integer 1–20. Example: 8. Default: 8.", "default": 8 } } }, "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 } } } } } } } } } }