IKEA
API de categoría de IKEA
Los productos de una categoría de IKEA por id o URL de categoría, con los mismos órdenes y filtros que la búsqueda: número de artículo, nombre, tipo, diseño, precio y precio anterior en la moneda del mercado, etiqueta de precio, valoración, variantes y ruta de categorías de cada producto, más la categoría (id, nombre, url, categorías superiores), el total y las facetas. En los 50 mercados de ikea.com y China (ikea.cn). 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/jsoncategory_idstringUn id de categoría: categories[].id del endpoint de categorías, o un id de category_path / facets de una búsqueda, por ejemplo 10382 = librerías y fu003 = sofás en us. Envía category_id o url.
Example: 10382
urlstringUna página de categoría de IKEA, como alternativa a category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usEl mercado de IKEA, como código en minúsculas. Este endpoint cubre 51 mercados: los 50 mercados de ikea.com y China (ikea.cn). 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.
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
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")
# Toma un id del árbol de IKEA España y lista esa categoría, del más barato al más caro.
tree = client.ikea.categories(country="es")["data"]["categories"]
cat_id = tree[0]["id"]
r = client.ikea.category(category_id=cat_id, country="es", sort="price_asc", page_size=48)["data"]
print(r["category"]["name"], r["total"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"])Response