# Elcorteingles Product Search Scraper (`stealth_mode/elcorteingles-product-search-scraper`) Actor

Scrape product listings from El Corte Inglés Portugal with 51+ data fields including pricing, inventory, images, and detailed product metadata. Perfect for price monitoring, market intelligence, and competitive analysis in Portuguese e-commerce.

- **URL**: https://apify.com/stealth\_mode/elcorteingles-product-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Developer tools, Automation, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## El Corte Inglés Product Scraper: Extract Retail Data at Scale

---

### What Is El Corte Inglés?

El Corte Inglés is one of Europe's largest retail chains, with a significant presence across Spain and Portugal. The Portuguese site (elcorteingles.pt) offers thousands of products spanning electronics, fashion, home & garden, sports, and more. For price trackers, market researchers, and e-commerce professionals, manually extracting this product data is inefficient — the **El Corte Inglés Product Scraper** automates collection from category pages, delivering complete product records in seconds.

---

### Overview

The **El Corte Inglés Product Search Scraper** extracts product listings from category and search result pages, capturing 51+ fields per item including pricing, stock status, images, variants, and rich metadata. It is ideal for:

- **Price monitoring services** tracking competitor pricing and promotions
- **E-commerce analysts** benchmarking product assortments and availability
- **Market researchers** studying Portuguese retail trends
- **Aggregator platforms** feeding El Corte Inglés inventory into comparison sites
- **Developers** building data-driven applications requiring Portuguese retail data

The scraper handles pagination automatically, supports bulk URL processing, and gracefully manages failed requests with the `ignore_url_failures` flag.

---

### Input Format

The scraper accepts a JSON configuration object with three main parameters:

```json
{
  "urls": [
    "https://www.elcorteingles.pt/tecnologia/som-e-imagem/2/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

| Parameter | Type | Description | Example |
|---|---|---|---|
| `urls` | Array (String) | URLs of product search/category pages to scrape | `["https://www.elcorteingles.pt/tecnologia/..."]` |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues running even if some URLs fail, instead of stopping on error | `true` or `false` |
| `max_items_per_url` | Integer | Maximum number of product items to extract per URL (limits dataset size and processing time) | `20`, `100`, `200` |

**Best practices:**

- Use category page URLs (e.g., `/tecnologia/som-e-imagem/`) rather than individual product pages
- Start with `max_items_per_url: 50` to test, then increase for full-scale runs
- Set `ignore_url_failures: true` for resilient bulk scraping

***

### Output Format

**Example output record:**

```json
{
  "description": "Long-Wear Cream Liner Stick",
  "brand": {
    "name": "Bobbi Brown",
    "slug": "bobbi-brown",
    "value": "29172864056"
  },
  "type": null,
  "product_id": null,
  "original_product_id": null,
  "product_variants": null,
  "media_objects": null,
  "varies_by": null,
  "digital_store": null,
  "store_code": null,
  "is_digital": null,
  "alternative_brands": null,
  "is_mandatory_info": null,
  "promotional_actions": [
    {
      "start_date_time": "2026-03-31T08:57Z",
      "end_date_time": "2050-02-28T22:59Z",
      "identifier": "237048200001",
      "priority": "5",
      "type": "informativa",
      "subtype": "01",
      "content_spots": [
        {
          "attributes": [],
          "identifier": "40",
          "position": "TITULO",
          "type": "Texto",
          "in_language": "pt_PT",
          "description": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€.",
          "tag": "promo_title",
          "zone_rules": [
            {
              "type": "DESTINO",
              "identifier": "97100"
            },
            {
              "type": "DESTINO",
              "identifier": "97101"
            }
          ]
        }
      ],
      "make_up": {
        "start_date_time": "2026-03-31T08:57Z",
        "end_date_time": "2050-02-28T22:59Z",
        "identifier": "70341",
        "priority": "5",
        "type": "I1",
        "subtype": "01",
        "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
      },
      "facet_promotion_type": [
        {
          "identifier": "008"
        }
      ],
      "is_s_p_o": true,
      "gifts": []
    }
  ],
  "categories": [
    {
      "id": "5007.33004429024",
      "name": "Perfumaria e Cosmética"
    }
  ],
  "product_line": null,
  "basic_color": null,
  "informative_messages": null,
  "product_original_id": "A200280507",
  "algolia_data": null,
  "base_url": "https://www.elcorteingles.pt/perfumaria-e-cosmetica/A200280507-long-wear-cream-liner-stick/?parentCategoryId=5007.33004429024",
  "canonical": "https://www.elcorteingles.pt/perfumaria-e-cosmetica/A200280507-long-wear-cream-liner-stick/?parentCategoryId=5007.33004429024",
  "is_collection": false,
  "is_edig": false,
  "my_colors": [
    {
      "all_images": [
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        },
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        },
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        }
      ],
      "common_sku": "001016965531987",
      "eci_common_reference": "001016965531987",
      "cross_selling": [],
      "hide_color": false,
      "is_favorite": false,
      "preselected": true,
      "title": "Aubergine",
      "thumbnail_url": "https://dam.elcorteingles.es/producto/www-001016965531987-to.jpg?impolicy=Resize&width=225&height=225",
      "videos": [],
      "not_available": false,
      "image": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "show_price": true,
      "has_double_size": false,
      "variants": [
        {
          "price": 42,
          "price_specification": {
            "price_currency": "EUR",
            "price_currency_code": "021",
            "price": 42,
            "sale_price": 42,
            "discount_percentage": "0",
            "pricing_adjustments": [
              {
                "promotional_action": {
                  "identifier": "237048200001",
                  "make_up": {
                    "start_date_time": "2026-03-31T08:57Z",
                    "end_date_time": "2050-02-28T22:59Z",
                    "identifier": "70341",
                    "priority": "5",
                    "type": "I1",
                    "subtype": "01",
                    "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
                  },
                  "facet_promotion_type": [
                    {
                      "identifier": "008"
                    }
                  ],
                  "type": "informativa",
                  "is_s_p_o": true,
                  "priority": "5",
                  "gifts": []
                }
              }
            ],
            "facet_promotion_type": [],
            "minimum_prices": [
              {
                "origin": "promociones",
                "total_price": 42
              },
              {
                "origin": "web",
                "total_price": 42
              }
            ],
            "pricing_model": "A"
          },
          "add_to_cart": "add",
          "all_images": [
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            },
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-01.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            },
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-02.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            }
          ],
          "eci_unique_code": "000000000158065601",
          "eci_reference": "001016965531987   ",
          "flags": {
            "coming_soon": false,
            "eci_exclusive": false,
            "express_delivery": false,
            "internet_exclusive": false,
            "new": false,
            "sustainability": false
          },
          "gtin": "0716170306162",
          "id": "001016965531987   ",
          "is_link_to_pdp": false,
          "is_marketplace": false,
          "origin": "DVD",
          "providers": [],
          "good_types": "COMPRA EN FIRME",
          "seller": "001",
          "sku_informativa_promos": [
            {
              "identifier": "237048200001",
              "make_up": {
                "start_date_time": "2026-03-31T08:57Z",
                "end_date_time": "2050-02-28T22:59Z",
                "identifier": "70341",
                "priority": "5",
                "type": "I1",
                "subtype": "01",
                "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
              },
              "facet_promotion_type": [
                {
                  "identifier": "008"
                }
              ],
              "type": "informativa",
              "is_s_p_o": true,
              "priority": "5",
              "gifts": [],
              "is_variant_specific": true,
              "color_variant_id": "Aubergine"
            }
          ],
          "sku_promo_badge_data": {},
          "all_promos": [
            {
              "id": "237048200001",
              "is_s_p_o": true,
              "products": [],
              "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€.",
              "number_gift_limit": 1,
              "is_variant_specific": true,
              "priority": 5,
              "type": "informativa",
              "color_variant_id": "Aubergine"
            }
          ],
          "sku": "001016965531987   ",
          "sku_for_similar_images": "001016965531987",
          "status": "add",
          "stock_reference": "001016965531987   :eci",
          "type": "Variante",
          "variant": {
            "price": 42,
            "price_specification": {
              "price_currency": "EUR",
              "price_currency_code": "021",
              "price": 42,
              "sale_price": 42,
              "discount_percentage": "0",
              "pricing_adjustments": [
                {
                  "promotional_action": {
                    "identifier": "237048200001",
                    "make_up": {
                      "start_date_time": "2026-03-31T08:57Z",
                      "end_date_time": "2050-02-28T22:59Z",
                      "identifier": "70341",
                      "priority": "5",
                      "type": "I1",
                      "subtype": "01",
                      "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
                    },
                    "facet_promotion_type": [
                      {
                        "identifier": "008"
                      }
                    ],
                    "type": "informativa",
                    "is_s_p_o": true,
                    "priority": "5",
                    "gifts": []
                  }
                }
              ],
              "facet_promotion_type": [],
              "minimum_prices": [
                {
                  "origin": "promociones",
                  "total_price": 42
                },
                {
                  "origin": "web",
                  "total_price": 42
                }
              ],
              "pricing_model": "A"
            },
            "title": "Variante",
            "full_title": "Variante",
            "value": "1,1 g",
            "value_main": "1,1 g",
            "value_manufacturer": "",
            "unique": false,
            "empty": false
          },
          "nutritional_info": [],
          "additional_information": {},
          "is_customized_from_w_p_c": false,
          "object_id": "001_001016965531987___",
          "canonical_url": {
            "url": "/perfumaria-e-cosmetica/A200280507-long-wear-cream-liner-stick/",
            "gtin": null,
            "blocks": {
              "variant_or_gtin": "0716170306162"
            },
            "config": {
              "active": false
            }
          },
          "is_show_offer": false,
          "available": true,
          "show_notify": false
        }
      ],
      "has_price_range": false,
      "coming_soon": false,
      "show_notify": false,
      "add_to_cart": "ADD",
      "status": "ADD",
      "has_promo_range": true
    },
    {
      "all_images": [
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        },
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        },
        {
          "ratio": 1,
          "sources": {
            "small": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
            "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
            "big": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
            "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg"
          },
          "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
          "is_look": false,
          "is_plain": false,
          "sequence": null
        }
      ],
      "common_sku": "001016965531953",
      "eci_common_reference": "001016965531953",
      "cross_selling": [],
      "hide_color": false,
      "is_favorite": false,
      "preselected": false,
      "title": "Jungle",
      "thumbnail_url": "https://dam.elcorteingles.es/producto/www-001016965531953-to.jpg?impolicy=Resize&width=225&height=225",
      "videos": [],
      "not_available": false,
      "image": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
      "show_price": true,
      "has_double_size": false,
      "variants": [
        {
          "price": 42,
          "price_specification": {
            "price_currency": "EUR",
            "price_currency_code": "021",
            "price": 42,
            "sale_price": 42,
            "discount_percentage": "0",
            "pricing_adjustments": [
              {
                "promotional_action": {
                  "identifier": "237048200001",
                  "make_up": {
                    "start_date_time": "2026-03-31T08:57Z",
                    "end_date_time": "2050-02-28T22:59Z",
                    "identifier": "70341",
                    "priority": "5",
                    "type": "I1",
                    "subtype": "01",
                    "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
                  },
                  "facet_promotion_type": [
                    {
                      "identifier": "008"
                    }
                  ],
                  "type": "informativa",
                  "is_s_p_o": true,
                  "priority": "5",
                  "gifts": []
                }
              }
            ],
            "facet_promotion_type": [],
            "minimum_prices": [
              {
                "origin": "promociones",
                "total_price": 42
              },
              {
                "origin": "web",
                "total_price": 42
              }
            ],
            "pricing_model": "A"
          },
          "add_to_cart": "add",
          "all_images": [
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-00.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            },
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-01.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            },
            {
              "ratio": 1,
              "sources": {
                "small": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
                "medium": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
                "big": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
                "zoom": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg"
              },
              "default_source": "https://dam.elcorteingles.es/producto/por-001016965531953-02.jpg",
              "is_look": false,
              "is_plain": false,
              "sequence": null
            }
          ],
          "eci_unique_code": "000000000158065602",
          "eci_reference": "001016965531953   ",
          "flags": {
            "coming_soon": false,
            "eci_exclusive": false,
            "express_delivery": false,
            "internet_exclusive": false,
            "new": false,
            "sustainability": false
          },
          "gtin": "0716170306193",
          "id": "001016965531953   ",
          "is_link_to_pdp": false,
          "is_marketplace": false,
          "origin": "DVD",
          "providers": [],
          "good_types": "COMPRA EN FIRME",
          "seller": "001",
          "sku_informativa_promos": [
            {
              "identifier": "237048200001",
              "make_up": {
                "start_date_time": "2026-03-31T08:57Z",
                "end_date_time": "2050-02-28T22:59Z",
                "identifier": "70341",
                "priority": "5",
                "type": "I1",
                "subtype": "01",
                "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
              },
              "facet_promotion_type": [
                {
                  "identifier": "008"
                }
              ],
              "type": "informativa",
              "is_s_p_o": true,
              "priority": "5",
              "gifts": [],
              "is_variant_specific": true,
              "color_variant_id": "Jungle"
            }
          ],
          "sku_promo_badge_data": {},
          "all_promos": [
            {
              "id": "237048200001",
              "is_s_p_o": true,
              "products": [],
              "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€.",
              "number_gift_limit": 1,
              "is_variant_specific": true,
              "priority": 5,
              "type": "informativa",
              "color_variant_id": "Jungle"
            }
          ],
          "sku": "001016965531953   ",
          "sku_for_similar_images": "001016965531953",
          "status": "add",
          "stock_reference": "001016965531953   :eci",
          "type": "Variante",
          "variant": {
            "price": 42,
            "price_specification": {
              "price_currency": "EUR",
              "price_currency_code": "021",
              "price": 42,
              "sale_price": 42,
              "discount_percentage": "0",
              "pricing_adjustments": [
                {
                  "promotional_action": {
                    "identifier": "237048200001",
                    "make_up": {
                      "start_date_time": "2026-03-31T08:57Z",
                      "end_date_time": "2050-02-28T22:59Z",
                      "identifier": "70341",
                      "priority": "5",
                      "type": "I1",
                      "subtype": "01",
                      "title": "Entrega ao domicílio GRÁTIS em Portugal Continental em compras acima de 50€."
                    },
                    "facet_promotion_type": [
                      {
                        "identifier": "008"
                      }
                    ],
                    "type": "informativa",
                    "is_s_p_o": true,
                    "priority": "5",
                    "gifts": []
                  }
                }
              ],
              "facet_promotion_type": [],
              "minimum_prices": [
                {
                  "origin": "promociones",
                  "total_price": 42
                },
                {
                  "origin": "web",
                  "total_price": 42
                }
              ],
              "pricing_model": "A"
            },
            "title": "Variante",
            "full_title": "Variante",
            "value": "1,1 g",
            "value_main": "1,1 g",
            "value_manufacturer": "",
            "unique": false,
            "empty": false
          },
          "nutritional_info": [],
          "additional_information": {},
          "is_customized_from_w_p_c": false,
          "object_id": "001_001016965531953___",
          "canonical_url": {
            "url": "/perfumaria-e-cosmetica/A200280507-long-wear-cream-liner-stick/",
            "gtin": null,
            "blocks": {
              "variant_or_gtin": "0716170306193"
            },
            "config": {
              "active": false
            }
          },
          "is_show_offer": false,
          "available": true,
          "show_notify": false
        }
      ],
      "has_price_range": false,
      "coming_soon": false,
      "show_notify": false,
      "add_to_cart": "ADD",
      "status": "ADD",
      "has_promo_range": true
    }
  ],
  "status": "ADD",
  "uri": "/perfumaria-e-cosmetica/A200280507-long-wear-cream-liner-stick/?parentCategoryId=5007.33004429024",
  "badges": {
    "express": false,
    "new": false,
    "exclusive": false,
    "eci_exclusive": false,
    "coming_soon": false,
    "express_delivery": false
  },
  "default_image": {
    "default_source": "https://www.elcorteingles.es/sgfm/SGFM/contents/images/common/no-image.png"
  },
  "id": "A200280507",
  "object_id": null,
  "image": {
    "ratio": 1,
    "sources": {
      "small": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "big": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg"
    },
    "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
    "is_look": false,
    "is_plain": false,
    "sequence": null,
    "color": "Aubergine"
  },
  "is_sold_by": null,
  "must_show_recommended_price": null,
  "priority_image": {
    "ratio": 1,
    "sources": {
      "small": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "medium": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "big": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
      "zoom": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg"
    },
    "default_source": "https://dam.elcorteingles.es/producto/por-001016965531987-00.jpg",
    "is_look": false,
    "is_plain": false,
    "sequence": null,
    "color": "Aubergine"
  },
  "provider": [
    {
      "name": "El Corte Ingles, S.A.",
      "provider_id": "001",
      "type": "eci"
    }
  ],
  "size_guide": "",
  "size_guide_type": null,
  "size_guide_details": {},
  "show_units": null,
  "sofa_configurator": null,
  "store_id": "309",
  "product_variant_type": null,
  "title": "Long-Wear Cream Liner Stick",
  "vendors": {
    "bazaar_voice": {
      "has_bazaar_voice": true,
      "url": "https://apps.bazaarvoice.com/deployments/elcorteingles-pt/main_site/production/pt_PT/bv.js",
      "seo": {
        "url": "http://seo.bazaarvoice.com/elcorteingles-53b99fca72c2d55df98dab8d68aa6190/Main_Site-pt_PT/reviews/product"
      }
    },
    "flix_media": {
      "has_flix_media": true,
      "src": "//media.flixfacts.com/js/loader.js",
      "flix_inpage": "flix-inpage",
      "flix_ean": "0716170306162",
      "flix_mpn": "",
      "flix_sku": "001016965531987   ",
      "flix_brand": "Bobbi Brown",
      "flix_distributor": "5840",
      "flix_language": "pt",
      "flix_price": "42",
      "flix_button": "",
      "flix_button_image": "",
      "flix_fallback_language": ""
    },
    "rich_relevance": {
      "has_rich_relevance": false
    },
    "similar_images": {
      "has_similar_images": false
    },
    "load_bee": {
      "has_load_bee": false
    },
    "revieve": {
      "has_revieve": false
    },
    "usizy": {
      "active": false
    },
    "x_sell": {
      "has_x_sell": true
    },
    "x_sell_look": {
      "has_x_sell_look": false
    },
    "retail_media": {
      "has_retail_media": false,
      "url": ""
    },
    "adobe_target": {
      "has_adobe_target": true,
      "url": "https://www.elcorteingles.pt",
      "endpoint": "https://edge.adobedc.net/ee/irl1/v2/interact?dataStreamId=10a15b7f-feda-499d-a45b-9a00aa1f148a"
    },
    "supplia": {
      "has_supplia": false,
      "expiration_time": 14400,
      "supplia_ids": [
        {
          "name": "Default",
          "id": "default",
          "supplia_id": 1
        },
        {
          "name": "Smartphone",
          "id": "5007.23355426024",
          "supplia_id": 1
        }
      ]
    }
  },
  "group_by": "Color",
  "is_ocio": null,
  "is_tickets_product": null,
  "is_gift_card": null,
  "is_aida_cross_sell_active": null,
  "has_v3d": null,
  "external_functions": {},
  "image_css_classes": "",
  "hierarchy": [
    "perfumaria-e-cosmetica"
  ],
  "cross_sell_modal": {
    "id": "5007.33004429024",
    "name": "Perfumaria",
    "priority": {
      "1": "wpc"
    }
  },
  "redirect_to_pdp": null,
  "is_first_x_sell_product": null,
  "stock": {
    "stock_d48": false,
    "stock_der": false,
    "stock_no": false,
    "click_and_car": true,
    "eci_express": true,
    "eci_pick_up": true,
    "home_delivery": true,
    "status": "add",
    "sts_pick_up": false,
    "sts_companies": false,
    "is_vpr": false,
    "show_notify": false,
    "mkp_preferred": {},
    "click_and_collect": {
      "eci": {
        "active": true
      },
      "sts": {
        "active": false,
        "companies": []
      }
    },
    "type": "STANDARD",
    "redirect_to_p_d_p": false,
    "is_shipping_hidden": false
  },
  "from_url": "https://www.elcorteingles.pt/search-nwx/?s=wear&stype=text_box_multi&json=1"
}
```

Each scraped product returns a comprehensive record with 51 fields organized by category:

#### Core Product Identity

| Field | Meaning |
|---|---|
| `ID` | Unique internal identifier for the product in El Corte Inglés system |
| `Product ID` | Primary product ID used for catalog management |
| `Original Product ID` | Original manufacturer or reference ID |
| `Product Original ID` | Alternative reference to the original product identifier |
| `Object ID` | Algolia/search engine object identifier |
| `Title` | Full product name/title as displayed on the website |
| `URI` | Unique resource identifier (URL path slug) for the product |
| `Canonical` | Canonical URL for the product page (important for SEO and deduplication) |

#### Brand & Classification

| Field | Meaning |
|---|---|
| `Brand` | Manufacturer or brand name |
| `Alternative Brands` | Other brand names associated with the product |
| `Type` | Product category or type (e.g., headphones, laptop, camera) |
| `Categories` | Full category hierarchy/breadcrumb path |
| `Product Line` | Product line or series name within the brand |
| `Hierarchy` | Complete product hierarchy taxonomy |

#### Product Variants & Options

| Field | Meaning |
|---|---|
| `Product Variants` | Available variants (color, size, capacity) |
| `Varies By` | Dimensions that the product varies on (e.g., color, size) |
| `Product Variant Type` | Type of variant configuration |
| `Size Guide` | URL or reference to sizing information |
| `Size Guide Type` | Type of size guide (clothing, shoes, general) |
| `Size Guide Details` | Detailed sizing chart or specifications |
| `Sofa Configurator` | Link to interactive furniture configurator (if applicable) |

#### Media & Imagery

| Field | Meaning |
|---|---|
| `Default Image` | Primary product image URL displayed in listings |
| `Image` | Product image reference or array of images |
| `Priority Image` | Highest-priority/hero image for the product |
| `Media Objects` | Collection of all media (images, videos, 3D models) |
| `Has V3D` | Boolean flag indicating if 3D/V3D model is available |
| `Image CSS Classes` | CSS classes applied to images for styling/layout |

#### Pricing & Availability

| Field | Meaning |
|---|---|
| `Stock` | Current inventory level or stock status (in stock, limited, out of stock) |
| `Must Show Recommended Price` | Flag to display original/recommended retail price |
| `Is Sold By` | Seller/vendor information (El Corte Inglés or third-party) |
| `Provider` | Product provider or supplier name |
| `Vendors` | List of vendors selling the product |
| `Digital Store` | Whether the product is available in digital/online store |
| `Is Digital` | Boolean indicating if the product is digital (not physical) |
| `Store Code` | Code for the physical store location |
| `Store ID` | ID of the store selling the product |

#### Product Details & Metadata

| Field | Meaning |
|---|---|
| `Description` | Full product description including features and specifications |
| `Informative Messages` | Important notices, warnings, or promotional messages |
| `Basic Color` | Primary color of the product |
| `My Colors` | Available color variants |
| `Show Units` | Whether to display unit measurements/quantities |

#### Status & Flags

| Field | Meaning |
|---|---|
| `Status` | Current listing status (active, inactive, seasonal) |
| `Badges` | Visual badges (e.g., "Best Seller", "New", "Eco-Friendly") |
| `Is Collection` | Whether this is a product collection/bundle |
| `Is Edig` | Flag for Edig (El Corte Inglés digital) product type |
| `Is Mandatory Info` | Whether mandatory product information is present |
| `Is Ocio` | Whether product belongs to leisure/entertainment category |
| `Is Tickets Product` | Boolean indicating if item is a ticket/experience |
| `Is Gift Card` | Whether the product is a gift card |
| `Is Aida Cross Sell Active` | AIDA cross-sell recommendation flag |
| `Is First X Sell Product` | First cross-sell product in the recommendation chain |

#### Promotions & Business Logic

| Field | Meaning |
|---|---|
| `Promotional Actions` | Active promotions or discount campaigns |
| `Algolia Data` | Raw Algolia search index metadata (contains additional semi-structured data) |
| `Base URL` | Base URL for the product or category |

#### UI/UX & Interaction Elements

| Field | Meaning |
|---|---|
| `Cross Sell Modal` | Data for related product recommendations in modal popup |
| `Redirect To PDP` | Whether to redirect to product detail page (PDP) |
| `External Functions` | External APIs or functions available for the product |

***

### How to Use

1. **Find category URLs** — Navigate to elcorteingles.pt, select a category (e.g., Technology → Sound & Image), and copy the page URL.
2. **Configure input** — Paste URL(s) into the `urls` array. Set `max_items_per_url` based on your needs (50–200 typical).
3. **Enable fault tolerance** — Keep `ignore_url_failures: true` to avoid interruptions if a page structure changes.
4. **Run the scraper** — Start the actor and monitor real-time progress.
5. **Download results** — Export as JSON, CSV, or Excel for analysis, pricing dashboards, or inventory systems.

**Tips for best results:**

- Use category page URLs, not individual product pages
- Start with smaller `max_items_per_url` values to test run quality
- Re-run periodically to track price changes and stock updates
- Combine with data transformation tools to normalize prices and formats

***

### Use Cases & Business Value

**Price Intelligence:** Feed pricing data into dynamic pricing engines to stay competitive with El Corte Inglés product costs.

**Market Research:** Analyze product assortment trends, brand representation, and feature distribution across categories.

**Inventory Insights:** Monitor stock availability and forecast demand based on inventory levels across product lines.

**Aggregation Platforms:** Populate comparison sites with real-time El Corte Inglés Portugal data for consumer-facing searches.

**Competitive Analysis:** Track competitor product launches, promotional campaigns, and category strategy.

By automating product data extraction, teams eliminate manual data entry, improve decision velocity, and unlock competitive intelligence that drives business strategy.

***

### Conclusion

The **El Corte Inglés Product Scraper** is a robust solution for anyone needing large-scale Portuguese retail data. With 51+ output fields capturing everything from pricing and stock to images and promotions, it delivers actionable intelligence in structured, machine-readable format. Start scraping today and transform raw product listings into strategic data assets.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.elcorteingles.pt/tecnologia/som-e-imagem/2/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "urls": [
        "https://www.elcorteingles.pt/tecnologia/som-e-imagem/2/"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

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

# Prepare the Actor input
run_input = {
    "urls": ["https://www.elcorteingles.pt/tecnologia/som-e-imagem/2/"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/elcorteingles-product-search-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 '{
  "urls": [
    "https://www.elcorteingles.pt/tecnologia/som-e-imagem/2/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/elcorteingles-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/elcorteingles-product-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Elcorteingles Product Search Scraper",
        "description": "Scrape product listings from El Corte Inglés Portugal with 51+ data fields including pricing, inventory, images, and detailed product metadata. Perfect for price monitoring, market intelligence, and competitive analysis in Portuguese e-commerce.",
        "version": "0.0",
        "x-build-id": "MhFrnHXMO915Sr8ra"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~elcorteingles-product-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-elcorteingles-product-search-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/stealth_mode~elcorteingles-product-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-elcorteingles-product-search-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/stealth_mode~elcorteingles-product-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-elcorteingles-product-search-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": {
                    "urls": {
                        "title": "URLs of the product search list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```