Other

El Corte Inglés API

El Corte Inglés API returns live El Corte Inglés data as clean JSON for el corte inglés The primary endpoint, search, returns product results including product id, product type, path, name and brand.

2 actionsLive JSON1,000 free creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to validate, enrich, classify and normalize operational data without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a El Corte Inglés scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product_detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Aug 6, 2026, 3:32 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/elcorteingles/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "zapatillas running",
    "max_results": 12
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "elcorteingles",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2868.4,
    "record_count": 8,
    "bytes": 1411946,
    "cache_hit": false,
    "completeness_pct": 66.67,
    "stop_reason": "limit_reached",
    "method": "ssr_state",
    "search_mode": "query",
    "robots": "disallowed_by_robots",
    "robots_note": "elcorteingles.es/robots.txt disallows /search-nwx/* for crawlers; browse by `category` for the robots-clean route to the same rows",
    "source": {
      "route": "/search-nwx/",
      "upstream_calls": 1
    },
    "sort": {
      "requested": null,
      "applied": "featuredDesc",
      "label": "Recomendados"
    },
    "sponsored_slots": 4,
    "pagination": {
      "page": 1,
      "per_page": 12,
      "pages_fetched": 1,
      "total_results": 2622,
      "total_pages": 219,
      "returned": 8,
      "has_more": true,
      "next_page": 2
    },
    "notes": null
  },
  "data": {
    "products": [
      {
        "product_id": "A57217734",
        "product_type": "catalog",
        "url": "https://www.elcorteingles.es/deportes/A57217734-blanco-pr-zapatillas-de-running-de-hombre-ua-ascend-under-armour/",
        "path": "/deportes/A57217734-blanco-pr-zapatillas-de-running-de-hombre-ua-ascend-under-armour/",
        "name": "[redacted-name]",
        "brand": "Under Armour",
        "brand_slug": "under-armour",
        "gtin13": "[redacted-phone]",
        "categories": [
          "Deportes"
        ],
        "hierarchy": [
          "deportes"
        ],
        "image": "https://dam.elcorteingles.es/producto/www-[redacted-phone].jpg",
        "colour_count": 1,
        "colours": [
          "Blanco"
        ],
        "variant_count": 3,
        "in_stock_variant_count": 3,
        "price": 26,
        "price_min": 26,
        "price_max": 26,
        "currency": "EUR",
        "availability": "in_stock",
        "is_marketplace": false,
        "sellers": [
          "001"
        ],
        "is_gift_card": false,
        "size_guide": null,
        "group_by": "Talla"
      },
      {
        "product_id": "A51072856",
        "product_type": "catalog",
        "url": "https://www.elcorteingles.es/deportes/A51072856-negro-pr-zapatillas-de-running-de-ninos-ua-bps-surge-4-ac-under-armour/",
        "path": "/deportes/A51072856-negro-pr-zapatillas-de-running-de-ninos-ua-bps-surge-4-ac-under-armour/",
        "name": "[redacted-name]",
        "brand": "Under Armour",
        "brand_slug": "under-armour",
        "gtin13": "[redacted-phone]",
        "categories": [
          "Deportes"
        ],
        "hierarchy": [
          "deportes"
        ],
        "image": "https://dam.elcorteingles.es/producto/www-[redacted-phone].jpg",
        "colour_count": 1,
        "colours": [
          "Negro"
        ],
        "variant_count": 3,
        "in_stock_variant_count": 1,
        "price": 12,
        "price_min": 12,
        "price_max": 12,
        "currency": "EUR",
        "availability": "partially_in_stock",
        "is_marketplace": false,
        "sellers": [
          "001"
        ],
        "is_gift_card": false,
        "size_guide": null,
        "group_by": "Talla"
      },
      {
        "product_id": "A55514634",
        "product_type": "catalog",
        "url": "https://www.elcorteingles.es/deportes/A55514634-negro-blanco-pr-zapatillas-de-running-de-hombre-patriot-14-asics/",
        "path": "/deportes/A55514634-negro-blanco-pr-zapatillas-de-running-de-hombre-patriot-14-asics/",
        "name": "[redacted-name]",
        "brand": "Asics",
        "brand_slug": "asics",
        "gtin13": "[redacted-phone]",
        "categories": [
          "Deportes"
        ],
        "hierarchy": [
          "deportes"
        ],
        "image": "https://dam.elcorteingles.es/producto/www-[redacted-phone].jpg",
        "colour_count": 1,
        "colours": [
          "Negro / Blanco"
        ],
        "variant_count": 11,
        "in_stock_variant_count": 11,
        "price": 32.5,
        "price_min": 32.5,
        "price_max": 32.5,
        "currency": "EUR",
        "availability": "in_stock",
        "is_marketplace": false,
        "sellers": [
          "001"
        ],
        "is_gift_card": false,
        "size_guide": "https://www.elcorteingles.es/deportes/calzado/tabla-de-tallas-asics/",
        "group_by": "Talla"
      }
    ]
  }
}

Actions

What the El Corte Inglés API does

Action	Description	Concrete use case	Key params
search	Search or browse elcorteingles.es. Give a Spanish free-text `query` ('zapatillas running', 'movil samsung', 'lavadora'), an El Corte Inglés product code or a bare EAN-13, or a `category` path to browse ('electronica/moviles-y-smartphones', 'moda-mujer/zapatos'). Every row carries El Corte Inglés' own product code, the product URL to feed straight into `product_detail`, the name, brand, EAN-13, price range across colours, the colour list, the variant count, how many of those variants are actually buyable, the image, the category hierarchy and whether the listing is a marketplace seller's. Sort by price, discount, rating, newness, name or stock; page through the whole result set. `category` browsing is the route El Corte Inglés' robots.txt allows and `meta.robots` reports which route answered.	Ops teams call search to search or browse elcorteingles.es.	query, category, page, max_results, sort
product_detail	Get one El Corte Inglés product in full, by URL, product code or EAN-13. ONE call returns the complete image gallery, the full colour x size variant matrix with a stable native variant id, an EAN-13, a price, a strike-through price and a live buyable flag on EVERY row, the specification table as El Corte Inglés publishes it (grouped, with their own glossary text), the brand, the availability, the star rating and the top customer reviews inline, plus the seller behind each variant (El Corte Inglés itself or a marketplace merchant), the active promotions and the EU-Omnibus 30-day lowest price. Supermarket products are supported too and return their EAN, gallery and full nutrition panel instead of a size matrix.	Developer tools call product_detail to get one El Corte Inglés product in full, by URL, product code or EAN-13.	url, product_id, ean, include_reviews, max_reviews

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/elcorteingles/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"zapatillas running","max_results":12}'

import requests

r = requests.post(
    "https://api.reefapi.com/elcorteingles/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "zapatillas running",
  "max_results": 12
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/elcorteingles/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "zapatillas running",
  "max_results": 12
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.elcorteingles.search with {"query":"zapatillas running","max_results":12}.

Use cases

Who uses this API and why

Ops teams use El Corte Inglés to search or browse elcorteingles.es.
Developer tools use El Corte Inglés to get one El Corte Inglés product in full, by URL, product code or EAN-13.
Validation workflows use El Corte Inglés to validate, enrich, classify and normalize operational data, all from one ReefAPI key and credit pool.

FAQ

Questions developers ask before integrating

What is the El Corte Inglés API?

El Corte Inglés API is a ReefAPI endpoint group for el corte inglés It returns live JSON through POST requests under /elcorteingles/v1.

Is the El Corte Inglés API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. El Corte Inglés calls use the same shared credit balance as every other ReefAPI engine.

Do I need a El Corte Inglés login or account?

No login to El Corte Inglés is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the El Corte Inglés data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the El Corte Inglés API use?

El Corte Inglés actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call El Corte Inglés from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call elcorteingles actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the El Corte Inglés API a El Corte Inglés scraper?

It is the managed alternative to a DIY El Corte Inglés scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same el corte inglés back as clean JSON.

Why does my El Corte Inglés scraper keep getting blocked?

Most El Corte Inglés scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / elcorteingles

El Corte Inglés

base /elcorteingles/v12 endpoints

post/elcorteingles/v1/search1 credit

Search or browse elcorteingles.es. Give a Spanish free-text `query` ('zapatillas running', 'movil samsung', 'lavadora'), an El Corte Inglés product code or a bare EAN-13, or a `category` path to browse ('electronica/moviles-y-smartphones', 'moda-mujer/zapatos'). Every row carries El Corte Inglés' own product code, the product URL to feed straight into `product_detail`, the name, brand, EAN-13, price range across colours, the colour list, the variant count, how many of those variants are actually buyable, the image, the category hierarchy and whether the listing is a marketplace seller's. Sort by price, discount, rating, newness, name or stock; page through the whole result set. `category` browsing is the route El Corte Inglés' robots.txt allows and `meta.robots` reports which route answered.

Parameter		Allowed / range	Description
query	optional	—	What to look for, in Spanish, across the whole elcorteingles.es catalogue ('zapatillas running', 'movil samsung', 'lavadora bosch', 'perfume mujer'). You may also pass an El Corte Inglés product code ('A56390869') or a bare EAN-13 ('8806097643135') — the site resolves both to the single matching product. Give `query` OR `category` (or both — `category` then scopes nothing, the keyword route wins and `meta.search_mode` says so). NOTE: keyword search uses elcorteingles.es' /search-nwx/ path, which their robots.txt disallows for crawlers; `category` browsing is the robots-clean route to the same rows and `meta.robots` reports which one answered your call.
category	optional	—	Browse one El Corte Inglés category instead of keyword searching — the path between elcorteingles.es/ and the trailing slash. A department on its own works (`electronica`, `deportes`, `libros`, `juguetes`, `hogar`, `moda-mujer`, `perfumeria`, `bebes`) and so does a real sub-category (`electronica/moviles-y-smartphones`, `electrodomesticos/lavadoras`, `moda-mujer/zapatos`, `deportes/ciclismo`, `libros/booktok`). Returns the same product rows, the same 12-per-page pagination and the same sorting as keyword search, and it is the route El Corte Inglés' robots.txt ALLOWS. ⚠ A sub-category they do not have does NOT 404 on their side — they quietly serve the parent department's page instead, with the site-wide 10,004 total and rows that have nothing to do with what you asked for. This API detects that (their page states which category it really served) and returns NOT_FOUND naming the fallback, rather than handing you a plausible wrong answer.
page = 1	optional	1–834	Which page of results to start from (1-834). El Corte Inglés serves 12 tiles per page and publishes no way to ask for more — page size is fixed at their end (`itemsPerPage`, `size` and `limit` are all silently ignored, measured). Their result set is capped at 10,004 products, i.e. 834 pages. Page until `meta.pagination.has_more` is false — asking for a page past the end returns NOT_FOUND naming the real last page, never an empty list.
max_results = 12	optional	1–60	How many products to return (1-60). Because El Corte Inglés fixes its own page at 12, asking for more fetches more of their pages — one upstream page request per 12 results, up to 5 pages per call. Each of those pages is roughly half a megabyte to a megabyte and a half of HTML on a residential exit, so this is the single biggest cost lever on this endpoint: `meta.pages_fetched` and `meta.bytes` report exactly what your call spent.
sort	optional	featuredDesc · priceAsc · priceDesc · bestSellerQtyDesc · newInAsc · stockDesc · nameAsc · nameDesc · discountPerDesc · ratingDesc	Result ordering. These are El Corte Inglés' OWN sort keys, taken verbatim from the sort menu their pages publish — not invented, and each one measurably changes the result order. Omit for their recommended order. An unknown value is rejected here rather than sent: elcorteingles.es answers an unknown sort key with HTTP 503, not with an ignored parameter.

Try in playground →

post/elcorteingles/v1/product_detail2 credits

Get one El Corte Inglés product in full, by URL, product code or EAN-13. ONE call returns the complete image gallery, the full colour x size variant matrix with a stable native variant id, an EAN-13, a price, a strike-through price and a live buyable flag on EVERY row, the specification table as El Corte Inglés publishes it (grouped, with their own glossary text), the brand, the availability, the star rating and the top customer reviews inline, plus the seller behind each variant (El Corte Inglés itself or a marketplace merchant), the active promotions and the EU-Omnibus 30-day lowest price. Supermarket products are supported too and return their EAN, gallery and full nutrition panel instead of a size matrix.

Parameter		Allowed / range	Description
url	optional	—	The product's elcorteingles.es URL, exactly as `search` returns it in `products[].url`. This is the ZERO-EXTRA-COST path: the URL is the only key El Corte Inglés' product page resolves, because it embeds a category and a slug that cannot be derived from an id. Give `url`, `product_id` or `ean`.
product_id	optional	—	El Corte Inglés' own product code — `A56390869` for their catalogue, `MP_0623819_261BZ152012640` for a marketplace listing, `B001018009401193` for a supermarket item. Accepted for convenience, but be aware it costs ONE EXTRA upstream call: elcorteingles.es serves no product-by-id route, so the code is resolved through their own search first (measured: 1 result, every time). Pass `url` when you already have it.
ean	optional	—	A bare EAN-13 / GTIN barcode. Resolved through El Corte Inglés' own search the same way `product_id` is (one extra call), which makes this endpoint usable for catalogue matching straight from a barcode. Returns NOT_FOUND if El Corte Inglés does not carry that barcode.
include_reviews = true	optional	—	Fetch the star rating and the top customer reviews (default true). El Corte Inglés does not publish either on its own product page — they come from Bazaarvoice, the review platform their page loads, in one extra ~2 KB request. Measured coverage is 27 of 48 live products across 9 categories: home, appliances and toys are well covered, books and fashion carry none at all. Set false to skip the call entirely.
max_reviews = 8	optional	1–8	How many reviews to return (1-8). Bazaarvoice's feed publishes at most 8 per page and this endpoint deliberately does not page through them — `rating.count` tells you the true total, which is frequently far larger (110 on one measured product).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/elcorteingles/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"zapatillas running","max_results":12}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}