{ "openapi": "3.0.1", "info": { "title": "Kaufland seller scraper for public marketplace seller leads", "description": "Scrape public Kaufland sellers across seven European storefronts. Get legal names, VAT, phones, emails, full imprints, product IDs, offer prices, ratings, provenance, and change monitoring in Apify datasets, JSON, CSV, and scheduled workflows, without seller logins or browser automation.", "version": "0.1", "x-build-id": "LX69CSv8ZBqCnuInh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~kaufland-sellers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~kaufland-sellers-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~kaufland-sellers-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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": { "startUrls": { "title": "Start URLs", "maxItems": 20, "type": "array", "description": "Paste public Kaufland search, product, shop, or seller imprint URLs. These take precedence over keyword discovery unless Source mode is set to queries only.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search queries", "maxItems": 10, "type": "array", "description": "Search brand or product terms on each selected Kaufland storefront.", "default": [ "cosrx" ], "items": { "type": "string" } }, "countries": { "title": "Storefronts", "minItems": 1, "maxItems": 7, "type": "array", "description": "Select storefronts for keyword searches. A direct URL always determines its own storefront.", "items": { "type": "string", "enum": [ "de", "at", "cz", "sk", "pl", "fr", "it" ], "enumTitles": [ "Germany (.de)", "Austria (.at)", "Czechia (.cz)", "Slovakia (.sk)", "Poland (.pl)", "France (.fr)", "Italy (.it)" ] }, "default": [ "de" ] }, "sourceMode": { "title": "Source mode", "enum": [ "auto", "urlsOnly", "queriesOnly" ], "type": "string", "description": "Choose whether to use direct URLs, keyword searches, or both when both input types are present.", "default": "auto" }, "sellerType": { "title": "Seller record filter", "enum": [ "all", "publicImprint" ], "type": "string", "description": "Keep all discovered sellers, or only sellers for which Kaufland returns a public imprint record.", "default": "all" }, "includeOfferContext": { "title": "Include offer context", "type": "boolean", "description": "Include retained offers and product intelligence for each seller, including visible prices, ranks, availability, brand, identifiers, ratings, and image URLs when published.", "default": true }, "includePublicImprint": { "title": "Read public seller details", "type": "boolean", "description": "Read the public seller information Kaufland publishes, including legal name, address, VAT, phone, email, country, and seller tenure.", "default": true }, "includeFullImprintText": { "title": "Include full imprint text", "type": "boolean", "description": "Keep the complete public imprint and published legal policy text when available, so you can audit the extracted fields.", "default": true }, "runMode": { "title": "Run mode", "enum": [ "snapshot", "changes" ], "type": "string", "description": "Return every matching seller in snapshot mode, or only new and changed sellers in changes mode.", "default": "snapshot" }, "monitorScope": { "title": "Monitor scope", "maxLength": 120, "type": "string", "description": "A readable name that keeps monitoring state separate between brands, regions, or scheduled jobs.", "default": "kaufland-default" }, "maxSellers": { "title": "Maximum sellers", "minimum": 1, "maximum": 250, "type": "integer", "description": "Global maximum number of unique seller rows across all URLs, queries, countries, and products.", "default": 10 }, "maxProductsPerSource": { "title": "Maximum products per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum product pages considered from each search or direct source before offers are read.", "default": 10 }, "maxOffersPerProduct": { "title": "Maximum offers per product", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum public competing offers retained from each product response. Increase this when you need a complete seller comparison.", "default": 25 }, "maxPagesPerSource": { "title": "Maximum pages per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum search or shop pages followed from one source. Direct product and imprint pages use one page.", "default": 10 }, "requestDelayMs": { "title": "Delay between requests", "minimum": 500, "maximum": 5000, "type": "integer", "description": "Pause between source requests to reduce load and keep runs predictable.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The tested default uses Apify's UNBLOCKER group because direct Kaufland requests are protected by Cloudflare. Proxy availability depends on your Apify plan.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }