{ "openapi": "3.0.1", "info": { "title": "Zara Price & New-In Watch: Products by Category", "description": "Zara products from 9 country stores as flat rows: name, price in currency units, price before the markdown, discount percent, colour, availability, NEW badge, photos, product URL. Read any category by id or URL; keep only sale or new-in items.", "version": "0.1", "x-build-id": "W97M5xCuoweuqqVGm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~zara-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-zara-products", "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/superslowsloth~zara-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-zara-products", "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/superslowsloth~zara-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-zara-products", "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", "required": [ "categories" ], "properties": { "store": { "title": "Zara store", "enum": [ "us/en", "gb/en", "es/es", "de/de", "fr/fr", "it/it", "jp/ja", "se/sv", "pl/pl" ], "type": "string", "description": "Which Zara country store to read. Each store has its own currency, language, prices and range. United States (USD), United Kingdom (GBP), Spain, Germany, France and Italy (EUR), Japan (JPY), Sweden (SEK) and Poland (PLN). Only stores that returned products, with a currency read off the storefront's own price strings, when measured on 2026-10-13 are listed. Category ids are the same in every store.", "default": "us/en" }, "categories": { "title": "Categories", "type": "array", "description": "Zara category ids or category page URLs, one per line. An id is the number in the URL after v1= (https://www.zara.com/us/en/woman-jeans-l1119.html?v1=2419242 is category 2419242) or in the store's category list at https://www.zara.com/us/en/categories?ajax=true. Each category is read in full and separately; a product that two categories both list is returned once, under the first. A category that only groups subcategories returns nothing, and the run log then names the subcategories to use instead.", "items": { "type": "string" } }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "Keep only products Zara currently marks down. Each row then carries the price before the markdown and the discount percent. Applied after the category is read, because Zara's endpoint has no filter, so Max products counts matching products only.", "default": false }, "onlyNew": { "title": "Only products tagged NEW", "type": "boolean", "description": "Keep only products carrying Zara's NEW badge: the new-in watch. Applied after the category is read, so Max products counts matching products only. Combine with Only products on sale to keep products that are both.", "default": false }, "maxItems": { "title": "Max products per category", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Return at most this many products for each category, in Zara's own order. Zara sends a whole category in one response (407 products for US jeans, 766 for 'the new'), so the cap limits what you are charged for, not what is downloaded.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (automatic datacenter exits) is the default. Zara's edge refuses roughly half of the requests from the datacenter pool with an Access Denied page; the actor retries each refused request from a fresh address, which is what the proxy is for.", "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 } } } } } } } } } }