# El Corte Inglés Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/elcorteingles/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 3 credits per call |
| **Documentation** | https://www.piloterr.com/library/elcorteingles-search |

## Description

El Corte Inglés Search API. Search product listings on elcorteingles.es by keyword or URL. Returns prices, brands, images and pagination via webunlocker.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/elcorteingles/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'marino' on elcorteingles.es

```json
{
  "results": [
    {
      "url": "https://www.elcorteingles.es/libros/A200910175-el-mundo-marino-nivel-3-tapa-blanda/",
      "brand": "VARIOS AUTORES",
      "price": 25.93,
      "title": "EL MUNDO MARINO. NIVEL 3  (Tapa blanda)",
      "currency": "EUR",
      "image_url": "https://dam.elcorteingles.es/producto/www-001025505053840-00.jpg",
      "old_price": 27.3,
      "product_id": "A200910175",
      "discount_percentage": 5
    },
    {
      "url": "https://www.elcorteingles.es/libros/A200910168-el-mundo-marino-nivel-1-tapa-blanda/",
      "brand": "VARIOS AUTORES",
      "price": 25.93,
      "title": "EL MUNDO MARINO. NIVEL 1  (Tapa blanda)",
      "currency": "EUR",
      "image_url": "https://dam.elcorteingles.es/producto/www-001025505053774-00.jpg",
      "old_price": 27.3,
      "product_id": "A200910168",
      "discount_percentage": 5
    },
    {
      "url": "https://www.elcorteingles.es/moda-mujer/A56842226-azul-marino-pr-bralette-lift/",
      "brand": "Tommy Hilfiger",
      "color": "Azul marino",
      "price": 23,
      "title": "Bralette Lift Azul marino",
      "images": [
        "https://dam.elcorteingles.es/producto/www-001027908302584-00.jpg",
        "https://dam.elcorteingles.es/producto/www-001027908302584-01.jpg",
        "https://dam.elcorteingles.es/producto/www-001027908302584-02.jpg",
        "https://dam.elcorteingles.es/producto/www-001027908302584-s0.jpg"
      ],
      "currency": "EUR",
      "image_url": "https://dam.elcorteingles.es/producto/www-001027908302584-00.jpg",
      "old_price": 47.9,
      "product_id": "A56842226",
      "discount_percentage": 52
    },
    {
      "url": "https://www.elcorteingles.es/parafarmacia/A15542120-8436601105844-pr-180-comprimidos-colageno-marino-collmar-drasanvi/",
      "brand": "Drasanvi",
      "price": 11.35,
      "title": "180 Comprimidos Colágeno Marino Collmar Drasanvi",
      "currency": "EUR",
      "image_url": "https://dam.elcorteingles.es/producto/www-001026358100498-00.jpg",
      "product_id": "A15542120"
    }
  ],
  "pagination": {
    "next": "https://www.elcorteingles.es/search-nwx/2/?s=marino&stype=text_box",
    "page": 1,
    "per_page": 12,
    "total_pages": 1314,
    "total_results": 15761
  }
}
```

## Documentation

## Overview
The **El Corte Inglés Search API** returns product listings from El Corte Inglés Spain (`www.elcorteingles.es`). Pass a **keyword** or a **full search URL**, optionally with **`page`**, and receive structured JSON with titles, prices, brands, images and pagination.

Use each result `url` or `product_id` with [El Corte Inglés Product](https://www.piloterr.com/library/elcorteingles-product) for the full product page.

## Quickstart
```
GET https://api.piloterr.com/v2/elcorteingles/search?query=marino
GET https://api.piloterr.com/v2/elcorteingles/search?query=marino&page=2
GET https://api.piloterr.com/v2/elcorteingles/search?query=https://www.elcorteingles.es/search-nwx/?s=marino&stype=text_box
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword or El Corte Inglés search URL |
| `page` | integer | no | 1-based page number (default: from URL or `1`) |
| `return_page_source` | boolean | no | Raw HTML as `{\"result\": \"...\"}` (default: `false`) |

## Listings (`results[]`)
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Product id (`A…` or `MP_…`) |
| `title` | string | Product title |
| `url` | string | Absolute product page URL |
| `image_url` | string \| null | Main card image |
| `price` | number \| null | Current price |
| `currency` | string | ISO currency (`EUR`) |
| `brand` | string \| null | Brand name |
| `color` | string \| null | Selected color when shown |
| `old_price` | number | Struck-through price when on promo |
| `discount_percentage` | number | Discount percent when on promo |
| `images` | string[] | Extra images when more than one is available |

## Pagination
| Field | Type | Description |
|---|---|---|
| `page` | integer | Current page |
| `per_page` | integer | Results per page (typically 12) |
| `total_results` | integer \| null | Total hits when available |
| `total_pages` | integer \| null | Total pages when available |
| `next` | string \| null | Next page URL, or `null` |

## Workflow
1. [El Corte Inglés Search](https://www.piloterr.com/library/elcorteingles-search) to discover products (this endpoint)
2. [El Corte Inglés Product](https://www.piloterr.com/library/elcorteingles-product) for full product JSON

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` |
| `404` | No parseable listings |
| `500` | Fetch or parsing error |

## Notes
- Spain only (`elcorteingles.es`).
- Promo / ad cards without a real product id are filtered out, so `results.length` can be lower than `per_page`.
- Costs **3 credits** per call (webunlocker).

## Main use cases
- **Catalog discovery**: collect product ids and URLs by keyword
- **Price monitoring**: track listing prices and promo discounts
- **Retail intelligence**: brand, color and availability signals at scale