Piloterr

El Corte Inglés Search

GET
/v2/elcorteingles/search

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

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Search keyword or full El Corte Inglés search URL.

Examples:

marino
https://www.elcorteingles.es/search-nwx/?s=marino&stype=text_box

Use El Corte Inglés Product on any result url or product_id for full PDP data.

page?number

1-based page number. Overrides /search-nwx/{page}/ when present in the URL (default: from URL or 1).

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw HTML as {"result": "..."} instead of structured JSON. Defaults to false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/elcorteingles/search?query=string'
Example Response
{  "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  }}