IKEA
API de búsqueda de IKEA
Busca productos de IKEA por palabra clave en cualquiera de 55 mercados: los 50 mercados de ikea.com, IKEA España incluida, y China (ikea.cn) devuelven la cuadrícula completa, 24 productos por página por defecto (hasta 100), con siete órdenes y filtros por color, tramo de precio, categoría, novedad, última oportunidad, precio IKEA Family, más vendidos, disponibilidad en tienda o cualquier faceta. Cada producto trae su número de artículo, nombre, tipo, diseño, precio y precio anterior en la moneda del mercado, etiqueta de precio ("Hemos bajado el precio", precio IKEA Family ...), valoración, variantes y ruta de categorías, más facetas, sugerencias de corrección, búsquedas relacionadas y tarjetas de contenido. Las tiendas franquiciadas (Puerto Rico, República Dominicana, Canarias y Baleares, Islandia) solo aceptan query y page. Cuesta 1 crédito por solicitud.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredPalabras clave, 1-200 caracteres, en cualquier idioma que sirva el mercado. También vale un número de artículo.
Example: kallax
countrystringdefault:usEl mercado de IKEA, como código en minúsculas. Este endpoint cubre 55 mercados: los 50 mercados de ikea.com, China (ikea.cn), Puerto Rico, República Dominicana, Canarias y Baleares e Islandia. Nombres, descripciones y etiquetas llegan en el idioma del mercado y los precios en su moneda, nunca convertidos; la respuesta repite country, language y currency. Un mercado fuera de esta lista responde 400 antes de cobrar nada.
Example: es
us— Estados Unidos, USD, idiomas en, es. Valor por defecto.ca— Canadá, CAD, idiomas en, fr.gb— Reino Unido, GBP, idioma en.ie— Irlanda, EUR, idioma en.de— Alemania, EUR, idiomas de, en.at— Austria, EUR, idiomas de, en.ch— Suiza, CHF, idiomas de, fr, it, en.fr— Francia, EUR, idioma fr.be— Bélgica, EUR, idiomas nl, fr, en.nl— Países Bajos, EUR, idiomas nl, en.dk— Dinamarca, DKK, idioma da.se— Suecia, SEK, idiomas sv, en.no— Noruega, NOK, idiomas no, en.fi— Finlandia, EUR, idiomas fi, sv, en.ee— Estonia, EUR, idiomas et, ru, en.lv— Letonia, EUR, idiomas lv, ru, en.lt— Lituania, EUR, idiomas lt, ru, en.pl— Polonia, PLN, idioma pl.cz— Chequia, CZK, idiomas cs, en.sk— Eslovaquia, EUR, idioma sk.hu— Hungría, HUF, idioma hu.hr— Croacia, EUR, idioma hr.si— Eslovenia, EUR, idioma sl.rs— Serbia, RSD, idioma sr.ro— Rumanía, RON, idioma ro.pt— Portugal, EUR, idiomas pt, en.es— España, EUR, idiomas es, en, ca, eu, gl.it— Italia, EUR, idioma it.il— Israel, ILS, idioma he.ae— Emiratos Árabes Unidos, AED, idiomas ar, en.sa— Arabia Saudí, SAR, idiomas ar, en.kw— Kuwait, KWD, idiomas ar, en.qa— Catar, QAR, idiomas ar, en.bh— Baréin, BHD, idiomas ar, en.om— Omán, OMR, idiomas ar, en.jo— Jordania, JOD, idiomas ar, en.eg— Egipto, EGP, idiomas ar, en.ma— Marruecos, MAD, idiomas ar, fr, en.in— India, INR, idioma en.my— Malasia, MYR, idiomas ms, en.sg— Singapur, SGD, idioma en.ph— Filipinas, PHP, idioma en.th— Tailandia, THB, idiomas th, en.jp— Japón, JPY, idiomas ja, en.kr— Corea del Sur, KRW, idiomas ko, en.au— Australia, AUD, idioma en.nz— Nueva Zelanda, NZD, idioma en.mx— México, MXN, idiomas es, en.cl— Chile, CLP, idioma es.co— Colombia, COP, idioma es.cn— China (ikea.cn), CNY, idiomas zh, en.pr— Puerto Rico, USD, idiomas en, es.do— República Dominicana, DOP, idiomas es, en.es_islands— Canarias y Baleares (envía island), EUR, idiomas es, en.is— Islandia, ISK, idiomas en, is.
languagestringEl idioma de la respuesta, uno de los que sirve la web del mercado; por defecto, el primero (es en es, en en us, de en de). En España: es, en, ca (catalán), eu (euskera) o gl (gallego). Otros mercados con varios idiomas: us en/es, mx es/en, ca en/fr, de y at de/en, ch de/fr/it/en, be nl/fr/en, nl nl/en, se sv/en, no no/en, fi fi/sv/en, ee et/ru/en, lv lv/ru/en, lt lt/ru/en, cz cs/en, pt pt/en, los mercados del Golfo y árabes ar/en (ma ar/fr/en), my ms/en, th th/en, jp ja/en, kr ko/en, cn zh/en, pr en/es, do y es_islands es/en, is en/is. El resto tiene un solo idioma. Otro código responde 400.
Example: ca
islandenum<string>Obligatorio con country es_islands (las tiendas online de Canarias y Baleares) y no admitido en otro caso: la isla cuya tienda se consulta.
Example: tenerife
tenerife— Tenerife (Canarias).grancanaria— Gran Canaria (Canarias).lanzarote— Lanzarote (Canarias).fuerteventura— Fuerteventura (Canarias).lapalma— La Palma (Canarias).lagomera— La Gomera (Canarias).elhierro— El Hierro (Canarias).mallorca— Mallorca (Baleares).menorca— Menorca (Baleares).ibiza— Ibiza (Baleares).
category_idstring | string[]Limita a id(s) de categoría de las facetas (parámetro f-subcategories), por ejemplo st002.
Example: st002
pageintegerdefault:1Página de resultados, desde 1. IKEA sirve los primeros 2000 resultados de una lista más una página, así que (page - 1) x page_size no puede pasar de 2000.
Example: 2
page_sizeintegerdefault:24Productos por página, 1-100.
Example: 48
sortenum<string>default:relevanceOrden de los resultados.
Example: price_asc
relevance— El orden de la propia web. Valor por defecto.price_asc— Más barato primero.price_desc— Más caro primero.newest— Novedades primero.rating— Mejor valorados primero.name_asc— Nombre de la A a la Z.most_popular— Más populares primero.
colorstring | string[]Id(s) de color de las facetas (parámetro f-colors), por ejemplo 10156 = blanco.
Example: 10156
price_bucketstringUn id de tramo de precio de las facetas (parámetro f-price-buckets), por ejemplo PRICE_0_5000 = de 0 a 49,99 en la moneda del mercado.
Example: PRICE_0_5000
new_onlybooleanSolo productos nuevos.
Example: true
last_chancebooleanSolo productos de última oportunidad (que dejan de venderse).
Example: true
family_pricebooleanSolo productos con precio de socio IKEA Family.
Example: true
top_sellerbooleanSolo los más vendidos.
Example: true
store_idstring | integerUn id de tienda (stores[].store_id del endpoint de tiendas). Añade la disponibilidad de cada producto en esa tienda (nivel de stock, envío a domicilio) y activa availability.
Example: 399
availabilityenum<string>Con store_id: in_store (en stock en la tienda, por defecto), click_collect u online.
Example: in_store
in_store— En stock en la tienda.click_collect— Disponible para recoger en la tienda (click & collect).online— Disponible online.
filtersobjectCualquier otra faceta, con la clave de facets[].parameter, por ejemplo {"f-materials": ["47350"]}. Las facetas booleanas aceptan true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX en IKEA España, del más barato al más caro. Precios en EUR;
# previous_price viene en los artículos con "Hemos bajado el precio".
r = client.ikea.search(query="kallax", country="es", sort="price_asc")["data"]
print(r["total"], "resultados,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"], i["previous_price"], i["price_tag"])Response