# El Corte Inglés Product

## Overview

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

## Description

El Corte Inglés Product API. Fetch a full product page from elcorteingles.es by URL or product id. Returns pricing, stock, images and identifiers via browser rendering.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### EL MUNDO MARINO Nivel 3 (A200910175)

```json
{
  "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",
  "in_stock": true,
  "image_url": "https://dam.elcorteingles.es/producto/www-001025505053840-00.jpg",
  "old_price": 27.3,
  "product_id": "A200910175",
  "availability": "in_stock",
  "discount_percentage": 5
}
```

## Documentation

## Overview
The **El Corte Inglés Product API** returns a full product page from El Corte Inglés Spain. Pass a **product URL** or a **product id** (`A…` / `MP_…`) and receive structured JSON with price, stock, brand, images, description and identifiers.

Browser rendering is used so the product page loads correctly. Costs **3 credits** per call.

Discover products first with [El Corte Inglés Search](https://www.piloterr.com/library/elcorteingles-search), then call this endpoint for the full record.

## Quickstart
```
GET https://api.piloterr.com/v2/elcorteingles/product?query=https://www.elcorteingles.es/libros/A200910175-el-mundo-marino-nivel-3-tapa-blanda/
GET https://api.piloterr.com/v2/elcorteingles/product?query=A200910175
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or product id (`A…` / `MP_…`) |
| `return_page_source` | boolean | no | Raw HTML as `{\"result\": \"...\"}` (default: `false`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | Product id (`A…` or `MP_…`) |
| `title` | string | Product title |
| `url` | string | Canonical product URL |
| `description` | string \| null | Long product description |
| `image_url` | string \| null | Main image |
| `images` | string[] \| null | Gallery URLs |
| `price` | number \| null | Current price |
| `old_price` | number | Previous price when on promo |
| `discount_percentage` | number | Discount percent when on promo |
| `currency` | string | ISO currency (`EUR`) |
| `brand` | string \| null | Brand |
| `color` | string \| null | Selected color |
| `category` | string \| null | Category path |
| `gtin` | string \| null | EAN / GTIN when available |
| `sku` | string \| null | Internal SKU |
| `reference` | string \| null | Catalog reference |
| `seller` | string \| null | Seller / marketplace provider |
| `in_stock` | boolean \| null | Availability flag |
| `availability` | string \| null | `in_stock` or `out_of_stock` |
| `attributes` | object[] \| null | Spec name/value pairs when exposed |

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

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` |
| `404` | Product not found or page not parseable |
| `500` | Rendering or parsing error |

## Notes
- Spain only (`elcorteingles.es`).
- Passing an id alone may first resolve the product URL via search, then load the product page.
- Some fields (`attributes`, multi-image gallery, promo fields) can be partial depending on the page.
- Costs **3 credits** per call (browser rendering).

## Main use cases
- **PDP enrichment**: title, price, stock, images and identifiers
- **Price monitoring**: track individual product price changes
- **Catalog sync**: structured retail data for CRM and pricing tools