{ "openapi": "3.0.1", "info": { "title": "Zalando Scraper — Product Prices, Stock & Images", "description": "Scrape product data from zalando.de, Europe's largest online fashion retailer. Extract names, brands, prices, sizes, stock and images for any search keyword or category URL (filters included) across thousands of brands, unblocked with Bright Data Web Unlocker.", "version": "0.1", "x-build-id": "ag8emBhy2EjiYUpnx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~zalando-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-zalando-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~zalando-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-zalando-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~zalando-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-zalando-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", "maxItems": 25, "type": "array", "description": "Search keywords to run on zalando.de's catalog search, e.g. \"adidas sneaker\" or \"Damen Kleider\". German or English both work. Leave this and Category URLs empty to use the default (\"Sneaker\").", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs", "maxItems": 25, "uniqueItems": true, "type": "array", "description": "Zalando category pages to scrape instead of (or alongside) a keyword search, e.g. \"https://www.zalando.de/herrenbekleidung-jacken/\" or \"https://www.zalando.de/damenbekleidung-kleider/\". Paste the full URL straight from your browser — any facet filters in the query string are kept and applied, e.g. \"https://www.zalando.de/herrenbekleidung-jacken/?upper_material=leder\" returns leather jackets only. A page number in the URL is ignored; the actor pages through the whole category itself up to Max Results. Search Queries keep working as before: set both and the actor runs both.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape across all search queries", "default": 100 }, "brightDataApiKey": { "title": "Bright Data API Key", "type": "string", "description": "Bright Data API key (Web Unlocker zone) used to reach zalando.de behind its Akamai anti-bot protection. Falls back to the actor's own BRIGHT_DATA_API_KEY environment variable if left empty." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Not used — this actor reaches zalando.de exclusively through Bright Data Web Unlocker (Akamai-protected, confirmed live), which handles unblocking on its own. Kept for input-shape compatibility." }, "fetchDetails": { "title": "Fetch product detail attributes", "type": "boolean", "description": "Fetch each product's own page for material, care, fit and other specifications (attributes) in addition to the listing data. Off by default. Costs ONE EXTRA Bright Data request per product on top of the listing requests, so it roughly doubles Bright Data usage and makes large runs take noticeably longer.", "default": false }, "maxDetailFetches": { "title": "Max detail fetches", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on how many product detail pages this run will fetch when \"Fetch product detail attributes\" is on. Protects against accidentally launching thousands of extra Bright Data requests on a large maxResults run. Ignored when fetchDetails is off.", "default": 500 } } }, "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 } } } } } } } } } }