{ "openapi": "3.0.1", "info": { "title": "Zara Scraper - Prices, Sizes, Stock and Images", "description": "Reads Zara's own catalogue: name, price, previous price and discount, currency, every colour a garment comes in, sizes with per-size stock and SKU, the full image gallery and the product link. Search by keyword, paste category or product links, or give category ids. Works on any Zara country store.", "version": "0.1", "x-build-id": "vaTdVdKPIasqXK5E0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~zara-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-zara-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/dami_studio~zara-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-zara-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/dami_studio~zara-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-zara-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for on Zara, one per line — \"linen shirt\", \"black blazer\", \"sneakers\". A product reference works too: paste 1957/102 or 01957102 and you get that product back.", "items": { "type": "string" } }, "startUrls": { "title": "Zara links", "type": "array", "description": "Paste Zara links, one per line. A category page (https://www.zara.com/us/en/woman-blazers-l1055.html?v1=2420942) returns everything in that category. A product page (…-p01957102.html) returns that product. A search link works too. Copy the link after the page has loaded so it carries the v1= number.", "items": { "type": "string" } }, "categoryIds": { "title": "Category ids", "type": "array", "description": "If you already know the numeric category ids, put them here instead of full links. This is the v1= number in a Zara category URL, not the number after the -l.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Zara store to read, exactly as it appears in the URL — us, gb, es, fr, de, it, jp, mx, ae, in, br and the rest. This decides the currency and which products are on sale there." }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code for that store — en for us/gb, es for es, fr for fr, and so on. If you get an \"unknown store\" note back, the pair is wrong; copy both from a real Zara URL." }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on rows across everything you asked for (1–5000). You are charged per product row returned, so this is also your spend cap." }, "includeSizes": { "title": "Fetch sizes and per-size stock", "type": "boolean", "description": "On by default. Zara's grid does not carry size names, so each product needs one extra lookup to get them. Turn this off for a faster, lighter run when you only need prices and images — the price you pay per row does not change either way." }, "onlyInStock": { "title": "Only products marked in stock", "type": "boolean", "description": "Keep only products Zara marks as in stock. Anything marked otherwise is dropped before it reaches the dataset, so you are not charged for it, and that includes low on stock, which can still be bought. A product that comes with no stock status is kept." }, "includeRelatedMatches": { "title": "Keep Zara's suggestions when a search has no match", "type": "boolean", "description": "Zara never replies \"no results\". A term it cannot match comes back as about 300 loosely related products, and they look convincing — search \"refrigerator\" and you get cooler boxes. By default those are dropped and you are not charged for them; the run tells you it happened. Switch this on if you want the suggestions anyway. Rows are marked \"related\" rather than \"exact\" either way." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave this alone unless you need the run to go out through a particular network. Your own proxy servers are used exactly as given." } } }, "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 } } } } } } } } } }