IKEA
API de recherche IKEA
Recherchez des produits IKEA par mot-clé sur l'un des 55 marchés : les 50 marchés ikea.com et la Chine (ikea.cn) renvoient la grille complète, 24 produits par page par défaut (jusqu'à 100), avec sept tris et des filtres de couleur, de tranche de prix, de catégorie, de nouveauté, de dernière chance, de prix IKEA Family, de meilleures ventes, de disponibilité en magasin ou toute autre facette. Chaque produit porte son numéro d'article, son nom, son type, son design, son prix et son ancien prix dans la devise du marché, son étiquette de prix (prix baissé, prix IKEA Family ...), sa note, ses variantes et son chemin de catégorie, avec en plus les facettes, le « vouliez-vous dire », les recherches associées et les cartes de contenu. Les sites franchisés (Porto Rico, République dominicaine, Canaries et Baléares, Islande) n'acceptent que query et page. Coûte 1 crédit par requête.
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/jsonquerystringrequiredMots-clés de recherche, de 1 à 200 caractères, dans une langue du marché. Un numéro d'article fonctionne aussi.
Example: kallax
countrystringdefault:usLe marché IKEA, en code minuscule (us par défaut). Cet endpoint couvre 55 marchés : les 50 marchés ikea.com, la Chine (ikea.cn), Porto Rico, la République dominicaine, les Canaries et les Baléares et l'Islande. Noms, descriptions et libellés arrivent dans la langue du marché et les prix dans sa devise, jamais convertis ; la réponse renvoie country, language et currency. Un marché hors de cette liste répond 400 avant tout débit.
Example: fr
us— États-Unis, USD, langues en, es. Valeur par défaut.ca— Canada, CAD, langues en, fr.gb— Royaume-Uni, GBP, langue en.ie— Irlande, EUR, langue en.de— Allemagne, EUR, langues de, en.at— Autriche, EUR, langues de, en.ch— Suisse, CHF, langues de, fr, it, en.fr— France, EUR, langue fr.be— Belgique, EUR, langues nl, fr, en.nl— Pays-Bas, EUR, langues nl, en.dk— Danemark, DKK, langue da.se— Suède, SEK, langues sv, en.no— Norvège, NOK, langues no, en.fi— Finlande, EUR, langues fi, sv, en.ee— Estonie, EUR, langues et, ru, en.lv— Lettonie, EUR, langues lv, ru, en.lt— Lituanie, EUR, langues lt, ru, en.pl— Pologne, PLN, langue pl.cz— République tchèque, CZK, langues cs, en.sk— Slovaquie, EUR, langue sk.hu— Hongrie, HUF, langue hu.hr— Croatie, EUR, langue hr.si— Slovénie, EUR, langue sl.rs— Serbie, RSD, langue sr.ro— Roumanie, RON, langue ro.pt— Portugal, EUR, langues pt, en.es— Espagne, EUR, langues es, en, ca, eu, gl.it— Italie, EUR, langue it.il— Israël, ILS, langue he.ae— Émirats arabes unis, AED, langues ar, en.sa— Arabie saoudite, SAR, langues ar, en.kw— Koweït, KWD, langues ar, en.qa— Qatar, QAR, langues ar, en.bh— Bahreïn, BHD, langues ar, en.om— Oman, OMR, langues ar, en.jo— Jordanie, JOD, langues ar, en.eg— Égypte, EGP, langues ar, en.ma— Maroc, MAD, langues ar, fr, en.in— Inde, INR, langue en.my— Malaisie, MYR, langues ms, en.sg— Singapour, SGD, langue en.ph— Philippines, PHP, langue en.th— Thaïlande, THB, langues th, en.jp— Japon, JPY, langues ja, en.kr— Corée du Sud, KRW, langues ko, en.au— Australie, AUD, langue en.nz— Nouvelle-Zélande, NZD, langue en.mx— Mexique, MXN, langues es, en.cl— Chili, CLP, langue es.co— Colombie, COP, langue es.cn— Chine (ikea.cn), CNY, langues zh, en.pr— Porto Rico, USD, langues en, es.do— République dominicaine, DOP, langues es, en.es_islands— Canaries et Baléares (avec island), EUR, langues es, en.is— Islande, ISK, langues en, is.
languagestringLa langue de la réponse, parmi celles du site du marché ; par défaut la première (en sur us, de sur de, fr sur fr). Marchés multilingues : us en/es, ca en/fr, de et 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, es es/en/ca/eu/gl, les marchés du Golfe et arabes ar/en (ma ar/fr/en), my ms/en, th th/en, jp ja/en, kr ko/en, mx es/en, cn zh/en, pr en/es, do et es_islands es/en, is en/is. Les autres marchés n'ont qu'une langue. Un autre code répond 400. Pour le français hors de France : be, ch, ca ou ma avec "language": "fr".
Example: fr
islandenum<string>Obligatoire avec country es_islands (les boutiques en ligne des Canaries et des Baléares), interdit sinon : la boutique de quelle île.
Example: tenerife
tenerife— Tenerife (Canaries).grancanaria— Grande Canarie (Canaries).lanzarote— Lanzarote (Canaries).fuerteventura— Fuerteventura (Canaries).lapalma— La Palma (Canaries).lagomera— La Gomera (Canaries).elhierro— El Hierro (Canaries).mallorca— Majorque (Baléares).menorca— Minorque (Baléares).ibiza— Ibiza (Baléares).
category_idstring | string[]Limite aux identifiants de catégorie issus des facettes (paramètre f-subcategories), par ex. st002.
Example: st002
pageintegerdefault:1Page de résultats, à partir de 1. IKEA sert les 2 000 premiers résultats d'une liste plus une page : (page - 1) x page_size ne peut pas dépasser 2 000.
Example: 2
page_sizeintegerdefault:24Produits par page, de 1 à 100.
Example: 48
sortenum<string>default:relevanceOrdre des résultats.
Example: price_asc
relevance— L'ordre du site. Par défaut.price_asc— Du moins cher au plus cher.price_desc— Du plus cher au moins cher.newest— Les nouveautés d'abord.rating— Les mieux notés d'abord.name_asc— Nom de A à Z.most_popular— Les plus populaires d'abord.
colorstring | string[]Identifiant(s) de couleur issus des facettes (paramètre f-colors), par ex. 10156 = blanc.
Example: 10156
price_bucketstringUn identifiant de tranche de prix issu des facettes (paramètre f-price-buckets), par ex. PRICE_0_2000 = 0,00 à 19,99 € sur fr.
Example: PRICE_0_5000
new_onlybooleanUniquement les nouveautés.
Example: true
last_chancebooleanUniquement les produits dernière chance (en fin de série).
Example: true
family_pricebooleanUniquement les produits avec un prix IKEA Family.
Example: true
top_sellerbooleanUniquement les meilleures ventes.
Example: true
store_idstring | integerUn identifiant de magasin (stores[].store_id de l'endpoint stores). Ajoute la disponibilité de chaque produit dans ce magasin (niveau de stock, livraison à domicile) et active availability.
Example: 399
availabilityenum<string>Avec store_id : in_store (en stock dans le magasin, par défaut), click_collect ou online.
Example: in_store
in_store— En stock dans le magasin.click_collect— Disponible en click and collect dans le magasin.online— Disponible en ligne.
filtersobjectToute autre facette, par sa clé facets[].parameter, par ex. {"f-materials": ["47350"]}. Les facettes booléennes prennent true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX en France, du moins cher au plus cher. Prix en EUR ; previous_price
# est renseigné sur les articles en prix baissé.
r = client.ikea.search(query="kallax", country="fr", sort="price_asc")["data"]
print(r["total"], "résultats,", 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