{ "openapi": "3.0.1", "info": { "title": "Zara Scraper - Prices, Sizes, Stock and Images", "description": "Scrape Zara's catalogue in a country store by search term, category or product link. Each product colour comes back with its price, previous price and discount, currency, colours, sizes with per-size stock and SKU, photos, reference and link. No account needed. $1.84 per 1,000 products.", "version": "0.1", "x-build-id": "gmv7ttsrtkebbgcd3" }, "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, like \"linen shirt\", \"black blazer\" or \"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 in stock or low on stock", "type": "boolean", "description": "Keep only products Zara marks in stock or low on stock, since both can be bought. Anything marked otherwise, such as sold out or coming soon, is dropped before it reaches the dataset, so you are not charged for it. With sizes on, a product whose every size is sold out is dropped too, even when Zara lists it as in stock. 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 } } } } } } } } } }