{ "openapi": "3.0.1", "info": { "title": "Mercateo (Unite) Scraper — B2B Products, Net Prices & EAN", "description": "Scrape Mercateo / Unite, Germany's B2B procurement marketplace (36 million articles): products by keyword or category with manufacturer, part number, EAN/GTIN, net and gross prices, quantity price tiers, every supplier offer, shipping costs and specifications. No login.", "version": "0.1", "x-build-id": "FxURPWkBv8efwdvXz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~mercateo-unite-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-mercateo-unite-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/yugenox~mercateo-unite-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-mercateo-unite-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/yugenox~mercateo-unite-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-mercateo-unite-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": { "keywords": { "title": "🔎 Keywords", "type": "array", "description": "Products to look for, as you would type them into Mercateo's search, e.g. \"akku bohrschrauber\", \"nitrilhandschuhe\", \"bürostuhl\", \"toner hp 305a\", or a part number. German terms find the most. Each keyword is searched separately. A main category such as \"Arbeitsschutz\" is searched through its sub-categories.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Mercateo links", "type": "array", "description": "Optional: Mercateo keyword pages (…/kw/…/….html), supplier catalogue categories (…/c/…/….html) or single products (…/p/…/….html) from www.mercateo.com.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max products", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of products for the whole run, shared fairly between your keywords and links. 0 = everything.", "default": 100 }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Also open every product page for the EAN/GTIN, every supplier offer shown (price, shipping, delivery time, stock), quantity price tiers (net and gross), shipping costs, return terms, all specifications, category path and all photos. One extra page per product, charged per product. Off = only what the result pages show (name, manufacturer, part number, lowest net price, number of offers, image).", "default": true }, "expandCategories": { "title": "Search sub-categories of overview pages", "type": "boolean", "description": "Some keywords (e.g. \"Arbeitsschutz\", \"Bürobedarf\") open a category overview instead of products. On: their sub-categories are searched (up to 30). Off: they are skipped and not charged.", "default": true }, "priceMin": { "title": "Min net price (€)", "minimum": 0, "type": "integer", "description": "Only products with at least this net price per unit (EUR, excl. VAT)." }, "priceMax": { "title": "Max net price (€)", "minimum": 0, "type": "integer", "description": "Only products up to this net price per unit (EUR, excl. VAT)." }, "manufacturers": { "title": "Manufacturers", "type": "array", "description": "Only products from these manufacturers, e.g. \"Bosch\", \"Makita\", \"3M\".", "items": { "type": "string" } }, "minOffers": { "title": "Min number of offers", "minimum": 0, "type": "integer", "description": "Only products that at least this many suppliers offer (good for price comparison)." }, "maxPagesPerSearch": { "title": "Max result pages per search", "minimum": 1, "type": "integer", "description": "Stop each keyword after this many result pages (15 products each). Empty = no limit, or 50 pages when filters are set." }, "maxConcurrency": { "title": "Parallel product pages", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many product pages are read at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. If Mercateo refuses datacenter IPs for a while, the run switches to residential proxies when your account has them.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }