# Zara Similar Product (`pintostudio/zara-similar-product`) Actor

Find similar Zara products from any product URL. Get price, stock, colors, sizes, images & category as clean JSON via API, schedule, or as a tool for AI agents and LLM/RAG workflows (MCP-ready). Covers 80+ Zara locales worldwide.

- **URL**: https://apify.com/pintostudio/zara-similar-product.md
- **Developed by:** [Pinto Studio](https://apify.com/pintostudio) (community)
- **Categories:** E-commerce, Other, Developer tools
- **Stats:** 2 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Zara Similar Products Scraper

Find and extract **similar products from Zara.com** in seconds. Give this Actor a single Zara product URL and it returns full, structured data - name, price, currency, discounts, available colors, sizes, stock/demand, images, and category - for every product Zara itself surfaces as similar or related, across **80+ country and language locales**.

Built on the [Apify platform](https://apify.com), this Zara scraper can be run manually from the Apify Console, triggered by the [Apify API](https://docs.apify.com/api/v2), scheduled to run automatically, or plugged straight into **AI agents and LLM workflows** (LangChain, LlamaIndex, CrewAI, AutoGen, custom GPTs, and any MCP-compatible client via the [Apify MCP Server](https://apify.com/apify/actors-mcp-server)) as a live fashion-data tool.

### Why use this Zara similar-products scraper?

- **AI agent and LLM ready** - expose Zara's own "similar products" recommendations as a callable tool for AI agents, RAG pipelines, and shopping copilots, with no HTML parsing or reverse engineering required on your side.
- **No coding required** - paste a product URL, pick a locale, click Run.
- **Global coverage** - 80+ Zara locales and countries, including the US, UK, Spain, France, Germany, Italy, Japan, South Korea, Brazil, Mexico, and more.
- **Rich, structured output** - price, discount and old price, stock/demand per size, hex color codes, product images, category/family, and the canonical product URL.
- **Reliable and maintained** - proxy-backed requests with automatic retries, returning clean JSON ready for a dataset, spreadsheet, or downstream API.
- **Instant integrations** - export straight to Google Sheets, Excel/CSV, Zapier, Make, webhooks, or your own database, no extra code.

### Who is this scraper for?

- **E-commerce and fashion teams** running competitor price monitoring, assortment planning, and trend analysis.
- **Dropshippers and resellers** looking for trending, similar, or alternative products to list.
- **Price-comparison and cashback platforms** that need live, structured Zara data.
- **Developers and AI/ML engineers** building shopping assistants, recommendation engines, or RAG knowledge bases grounded in real product data, not stale training data.
- **Market researchers** tracking fashion pricing and trends across regions.

### How it works

1. Provide a `productUrl` for any live product page on zara.com.
2. Optionally choose a `locale` (defaults to `en_US`) to search a specific Zara country store and language.
3. The Actor resolves the product on Zara's own catalog, requests Zara's internal "customers also viewed / similar products" recommendation feed for that product ID, and normalizes every recommended product into clean, consistent JSON.
4. Results are pushed to the run's default **dataset** (one item per similar product found) and a run summary is also saved to the **key-value store**.

### Input

| Field | Type | Required | Description |
|---|---|---|---|
| `productUrl` | string | Yes | Full URL of a Zara product page, e.g. `https://www.zara.com/us/en/flat-jelly-sandals-p11309800.html` |
| `locale` | string (enum) | No, default `en_US` | Language and country locale in `language_COUNTRY` format (e.g. `es_ES`, `de_DE`, `fr_FR`, `en_GB`, `ja_JP`) |

See the Input tab for the full list of 80+ supported locales.

### Output example

Each item pushed to the dataset represents one similar product and looks like this (trimmed for readability):

```json
{
  "id": "409877385",
  "name": "FLAT JELLY SANDALS",
  "reference": "2318/310",
  "description": "Flat sandals. Padded straps...",
  "pricing": { "value": "39.90", "currency": "USD" },
  "colors": [
    {
      "name": "Black",
      "hexCode": "#000000",
      "price": "39.90",
      "sizes": [ { "description": "39", "sku": 416727195, "demand": "low_stock" } ],
      "images": ["https://static.zara.net/assets/.../image.jpg"]
    }
  ],
  "images": ["https://static.zara.net/assets/.../image1.jpg"],
  "familyName": "Sandals",
  "sectionName": "WOMAN",
  "url": "https://www.zara.com/us/en/flat-jelly-sandals-p11309800.html"
}
```

A full JSON Schema of every field (including all color, size and pricing sub-fields) is defined in the Actor's dataset schema and shown in the **Output** tab.

Grab the full results via **Dataset -> Export** (JSON, CSV, Excel, XML, RSS) or through the Apify API/SDK.

### Using this Actor with AI agents and LLMs

This Actor is designed to work as a **tool call for AI agents**: instead of letting an LLM guess or hallucinate product data from stale training data, give it a Zara product URL and let it fetch live, structured "similar products" data on demand. Typical patterns:

- **MCP tool** - connect through the [Apify MCP Server](https://apify.com/apify/actors-mcp-server) so any MCP-compatible agent (Claude, Cursor, custom agents) can call this Actor directly as a tool, no custom integration code needed.
- **RAG pipelines** - feed the JSON output into a vector store to ground a shopping assistant or chatbot in real, current Zara catalog data.
- **Agent frameworks** - call the Actor via the [Apify API](https://docs.apify.com/api/v2) or the `apify-client` SDK from LangChain, LlamaIndex, CrewAI, AutoGen, or n8n/Make/Zapier AI workflows.
- **Function/tool calling** - wrap the Actor's input and output schema as an OpenAI or Anthropic function/tool definition for structured, reliable calls.

### Integrations

Connect this Actor to Zapier, Make, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more using [Apify Integrations](https://apify.com/integrations), or configure webhooks to trigger downstream workflows on every completed run.

### Cost and performance

A typical run for one product URL finishes in well under a minute and uses a small fraction of a compute unit. See the Pricing tab for exact numbers and the actor's pay-per-usage details.

### FAQ

**Does this Actor scrape Zara's whole catalog?**
No. It takes one product URL as a "seed" and returns the similar/recommended products that Zara itself surfaces for that item, in the locale you choose.

**Can I run this on a schedule?**
Yes. Use Apify Schedules to run it hourly, daily, or weekly and track price, stock, or assortment changes over time.

**Which countries and languages are supported?**
80+ Zara locales, including the US, UK, Spain, France, Germany, Italy, Portugal, Netherlands, Japan, South Korea, China, Hong Kong, Taiwan, Australia, Canada, Brazil, Mexico, Argentina, Chile, Colombia, Peru, Thailand, Vietnam, Indonesia, and more.

**Can I use this with ChatGPT, Claude, or my own AI agent?**
Yes. Call the Actor through the Apify API, the Apify MCP Server, or any HTTP client from your agent or automation framework, then feed the returned JSON straight into your LLM's context or a vector database.

**Is this Actor affiliated with Zara or Inditex?**
No. This is an independent tool built on publicly available data from zara.com and is not affiliated with, endorsed by, or sponsored by Zara or Inditex.

### Related

Looking for more retail and fashion scrapers, or want a custom AI agent integration? Check out Pinto Studio's other Actors on the [Apify Store](https://apify.com/pintostudio).

# Actor input Schema

## `productUrl` (type: `string`):

The full product url (e.g., 'https://www.zara.com/us/en/flat-jelly-sandals-p11309800.html')

## `locale` (type: `string`):

Language and country locale (format: language_COUNTRY)

## Actor input object example

```json
{
  "productUrl": "https://www.zara.com/us/en/flat-jelly-sandals-p11309800.html",
  "locale": "en_US"
}
```

# Actor output Schema

## `similarProducts` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("pintostudio/zara-similar-product").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("pintostudio/zara-similar-product").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call pintostudio/zara-similar-product --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pintostudio/zara-similar-product"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sqoPtUFqnNzUJqXhN/builds/pb5Hn5e4THdN5Nm0v/openapi.json