# Zara Product Scraper β€” Prices, Stock & Variants (`khadinakbar/zara-product-scraper`) Actor Extract validated Zara product data from product URLs, search terms, or category pages. Get prices, sale prices, availability, images, color and size options, descriptions, and canonical URLs for fashion research and monitoring. Pay only for complete product rows. - **URL**: https://apify.com/khadinakbar/zara-product-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** E-commerce, Automation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 product scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zara Product Scraper β€” Prices, Stock & Variants Extract structured Zara catalogue data from direct product URLs, Zara search pages, category pages, or simple product search terms. This actor is designed for fashion analysts, ecommerce teams, price-monitoring workflows, and AI agents that need a small, clean record for each public Zara product. It returns price and previous price, availability text, images, color and size options, description, product reference, canonical URL, and scrape provenance. ### What this Zara scraper extracts Every saved dataset item is validated before it is written or billed. Fields stay consistent across direct URLs and discovery runs. | Field | Description | | --- | --- | | `productId`, `reference`, `name` | Zara identifiers and the storefront title | | `price`, `originalPrice`, `currency` | Current public price, prior price when displayed, and currency | | `availability` | Zara's public stock or availability text; never inferred | | `colors`, `sizes`, `images` | Available product options and public image URLs | | `description`, `category`, `url` | Product context and canonical product URL | | `sourceType`, `searchTerm`, `scrapedAt` | Discovery provenance and timestamp | ### When to use it Use direct product URLs when monitoring a known assortment, sale prices, or availability. Direct URLs have the clearest scope and are the best choice for scheduled price tracking. Use a Zara search URL or `searchTerms` when discovering new products that match a concept such as `linen shirt`, `black dress`, or `kids trainers`. Use category URLs when a merchandising team needs a bounded slice of a localized catalogue. This actor is not a shopping bot. It does not log in, add products to a bag, make purchases, access private customer data, or guarantee store-level inventory. Availability is the exact public text exposed by Zara at scrape time, and can differ by location or change quickly. ### Input Provide either `startUrls`, `searchTerms`, or both. Start URLs can be Zara product pages, Zara search URLs, or category URLs. Search terms build a public Zara search URL using the selected storefront. URLs keep their own storefront, so a UK product page is not rewritten when `country` is set to US. ```json { "startUrls": [ "https://www.zara.com/us/en/search?searchTerm=linen" ], "searchTerms": ["linen shirt"], "country": "US", "maxProducts": 25, "maxScrollsPerListing": 3, "includeVariants": true } ```` `maxProducts` is a global hard cap, not a suggestion. The actor limits discovery, verifies the cap again immediately before a dataset write, and never intentionally charges more product events than this number. `maxScrollsPerListing` controls lazy-load scrolling only for search and category pages. Start with the default of three; raising it increases browser time but can discover more cards on long listings. The default proxy configuration uses Apify Residential proxies. Zara currently uses bot protections, so a real browser and a consistent proxy session are necessary for reliable catalogue access. You may provide a compatible Apify proxy configuration, but do not paste proxy credentials into the input. ### Output The default dataset has one row per complete validated product. Diagnostics never pollute the result dataset. Instead, `OUTPUT` gives a compact machine-readable outcome and `RUN_SUMMARY` records safe counts, warning samples, errors, and the cost cap. ```json { "productId": "05644401", "reference": "5644/401/800", "name": "LINEN BLEND SHIRT", "description": "Relaxed fit shirt made from a linen blend.", "price": 49.9, "originalPrice": null, "currency": "USD", "availability": "In stock", "colors": ["Ecru", "Navy blue"], "sizes": ["S", "M", "L"], "images": ["https://static.zara.net/photos/example.jpg"], "category": "WOMAN / SHIRTS", "url": "https://www.zara.com/us/en/linen-blend-shirt-p05644401.html", "sourceType": "searchTerm", "searchTerm": "linen shirt", "scrapedAt": "2026-07-15T17:00:00.000Z" } ``` ### Price and platform usage The actor charges **$0.004 per saved product**. A product is billed only after its full record passes schema validation and is persisted in the default dataset. There is also Apify's small actor-start event and platform usage, including browser and proxy use. For example, 25 saved products cost at most $0.10 in product events, plus platform usage. Set `maxProducts` to control this upper bound before starting a run. ### Reliability and limits The actor uses a browser rather than a synthetic HTTP client because Zara is a JavaScript storefront and applies Akamai protections. It checks for challenge pages, retires the affected session, retries bounded requests, and writes a truthful terminal outcome. `COMPLETE` means all scheduled product records were written. `PARTIAL` means some usable products were saved while cards, URLs, or sessions failed. `VALID_EMPTY` means a valid search or listing did not expose matching products. `INVALID_INPUT` indicates a URL or input problem. `UPSTREAM_FAILED` is reserved for a target outage or global block with no useful rows. Zara can change page markup, prices, product titles, localization, or bot defenses without notice. For that reason, use direct product URLs for production monitoring and keep the actor's result cap small while validating a new country or category. Product cards that cannot be converted into a complete record are skipped and counted in `RUN_SUMMARY`; the actor never invents a minimal billable row. ### API and agent use Run the actor from the Apify Console, API, scheduled task, or Apify MCP integration. The most natural agent call is a short list of product URLs with `maxProducts` equal to the desired record count. The output is intentionally flat and typed so it can be exported as JSON, CSV, Excel, or passed to a price-monitoring or catalogue-comparison step. ### Legal and responsible use Use this actor only for public data and in accordance with Zara's terms, applicable law, and your organization’s policies. Do not use it to collect personal data, bypass account controls, or automate purchases. Prices and availability are observations, not guarantees; verify any commercial decision with Zara directly. # Actor input Schema ## `startUrls` (type: `array`): Use this when you already have Zara URLs to scrape. Add full Zara product pages, category pages, or search URLs such as https://www.zara.com/us/en/search?searchTerm=linen. Duplicate URLs are ignored and non-Zara domains are rejected. This field is not for product names without a URL. ## `searchTerms` (type: `array`): Use this when you want the Actor to construct Zara search pages from product terms. Enter words such as linen shirt or black dress; each term is a separate discovery query. The selected country controls constructed search URLs. This field is not needed when startUrls already contains a Zara search page. ## `country` (type: `string`): Use this when searchTerms should run on a particular Zara storefront. Select US, UK, Spain, Germany, France, Italy, Portugal, Brazil, or Mexico; product and category URLs keep their own storefront. The default US creates https://www.zara.com/us/en/search URLs. This field does not rewrite URLs supplied in startUrls. ## `maxProducts` (type: `integer`): Use this to set a strict global output and billing cap. The Actor stops scheduling products before the cap and checks it again immediately before every paid dataset write. The default of 25 costs at most $0.10 in product events. This field is not a page-count setting. ## `maxScrollsPerListing` (type: `integer`): Use this when a Zara search or category page needs more lazy-loaded product cards. Each scroll waits briefly for new cards, then discovery stops at the configured cap. The default of 3 keeps the browser run short and predictable. This field has no effect for direct product URLs. ## `includeVariants` (type: `boolean`): Use this when you need product color and size options exposed on the product page. Disable it for a smaller record and slightly faster detail extraction. Availability remains a product-level signal and is not inferred from missing size controls. This field does not add cart or checkout automation. ## `proxyConfiguration` (type: `object`): Use this to override the default Apify Residential proxy configuration when your account has a compatible proxy setup. The default uses the RESIDENTIAL group because Zara applies bot protections. Keep a sticky session per browser request for consistent cookies. This field is not for pasting proxy credentials. ## Actor input object example ```json { "startUrls": [ "https://www.zara.com/us/en/search?searchTerm=linen" ], "searchTerms": [ "linen" ], "country": "US", "maxProducts": 5, "maxScrollsPerListing": 1, "includeVariants": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Validated product records with price, stock, images, variants, and source URLs. ## `output` (type: `string`): Compact stable terminal outcome and result count. ## `runSummary` (type: `string`): Detailed safe diagnostics, cost-cap state, and source counts. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.zara.com/us/en/search?searchTerm=linen" ], "searchTerms": [ "linen" ], "country": "US", "maxProducts": 5, "maxScrollsPerListing": 1, "includeVariants": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/zara-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.zara.com/us/en/search?searchTerm=linen"], "searchTerms": ["linen"], "country": "US", "maxProducts": 5, "maxScrollsPerListing": 1, "includeVariants": True, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/zara-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.zara.com/us/en/search?searchTerm=linen" ], "searchTerms": [ "linen" ], "country": "US", "maxProducts": 5, "maxScrollsPerListing": 1, "includeVariants": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call khadinakbar/zara-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/zara-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zara Product Scraper β€” Prices, Stock & Variants", "description": "Extract validated Zara product data from product URLs, search terms, or category pages. Get prices, sale prices, availability, images, color and size options, descriptions, and canonical URLs for fashion research and monitoring. Pay only for complete product rows.", "version": "1.4", "x-build-id": "C5n1ROfwyyHyjjq4O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~zara-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-zara-product-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/khadinakbar~zara-product-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-zara-product-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/khadinakbar~zara-product-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-zara-product-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": { "startUrls": { "title": "Zara product, category, or search URLs", "maxItems": 50, "type": "array", "description": "Use this when you already have Zara URLs to scrape. Add full Zara product pages, category pages, or search URLs such as https://www.zara.com/us/en/search?searchTerm=linen. Duplicate URLs are ignored and non-Zara domains are rejected. This field is not for product names without a URL.", "items": { "type": "string", "minLength": 10 }, "default": [] }, "searchTerms": { "title": "Product search terms", "maxItems": 20, "type": "array", "description": "Use this when you want the Actor to construct Zara search pages from product terms. Enter words such as linen shirt or black dress; each term is a separate discovery query. The selected country controls constructed search URLs. This field is not needed when startUrls already contains a Zara search page.", "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "default": [] }, "country": { "title": "Storefront for search terms", "enum": [ "US", "GB", "ES", "DE", "FR", "IT", "PT", "BR", "MX" ], "type": "string", "description": "Use this when searchTerms should run on a particular Zara storefront. Select US, UK, Spain, Germany, France, Italy, Portugal, Brazil, or Mexico; product and category URLs keep their own storefront. The default US creates https://www.zara.com/us/en/search URLs. This field does not rewrite URLs supplied in startUrls.", "default": "US" }, "maxProducts": { "title": "Maximum products for the run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to set a strict global output and billing cap. The Actor stops scheduling products before the cap and checks it again immediately before every paid dataset write. The default of 25 costs at most $0.10 in product events. This field is not a page-count setting.", "default": 25 }, "maxScrollsPerListing": { "title": "Listing scrolls", "minimum": 0, "maximum": 20, "type": "integer", "description": "Use this when a Zara search or category page needs more lazy-loaded product cards. Each scroll waits briefly for new cards, then discovery stops at the configured cap. The default of 3 keeps the browser run short and predictable. This field has no effect for direct product URLs.", "default": 3 }, "includeVariants": { "title": "Include color and size options", "type": "boolean", "description": "Use this when you need product color and size options exposed on the product page. Disable it for a smaller record and slightly faster detail extraction. Availability remains a product-level signal and is not inferred from missing size controls. This field does not add cart or checkout automation.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use this to override the default Apify Residential proxy configuration when your account has a compatible proxy setup. The default uses the RESIDENTIAL group because Zara applies bot protections. Keep a sticky session per browser request for consistent cookies. This field is not for pasting proxy credentials.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } }, "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 } } } } } } } } } } ```