IKEA
IKEA Search API
Zoek IKEA-producten op trefwoord op een van 55 markten: de 50 ikea.com-markten en China (ikea.cn) geven het volledige raster, standaard 24 producten per pagina (tot 100), met zeven sorteringen en filters op kleur, prijsklasse, categorie, nieuw, laatste kans, IKEA Family-prijs, bestseller, beschikbaarheid in de winkel of elk facet. Elk product heeft artikelnummer, naam, type, uitvoering, prijs en oude prijs in de valuta van de markt, prijslabel (nieuwe lagere prijs, IKEA Family-prijs ...), beoordeling, varianten en categoriepad, plus facetten, bedoelde-u-suggesties, gerelateerde zoekopdrachten en inhoudskaarten. De franchisesites (Puerto Rico, Dominicaanse Republiek, Canarische en Balearische Eilanden, IJsland) nemen alleen query en page. Kost 1 credit per verzoek.
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/jsonquerystringrequiredZoektermen, 1-200 tekens, in elke taal die de markt aanbiedt. Een artikelnummer werkt ook.
Example: kallax
countrystringdefault:usDe IKEA-markt als code in kleine letters. Dit endpoint bedient 55 markten: de 50 ikea.com-markten, China (ikea.cn), Puerto Rico, de Dominicaanse Republiek, de Canarische en Balearische Eilanden en IJsland. Namen, beschrijvingen en labels komen terug in de taal van de markt en prijzen in de eigen valuta, nooit omgerekend; het antwoord herhaalt country, language en currency. Een markt buiten deze lijst geeft een 400 voordat er iets wordt aangerekend. "nl" is IKEA Nederland, "be" IKEA België (standaard in het Nederlands).
Example: nl
us— Verenigde Staten, USD, talen en, es. De standaardwaarde.ca— Canada, CAD, talen en, fr.gb— Verenigd Koninkrijk, GBP, taal en.ie— Ierland, EUR, taal en.de— Duitsland, EUR, talen de, en.at— Oostenrijk, EUR, talen de, en.ch— Zwitserland, CHF, talen de, fr, it, en.fr— Frankrijk, EUR, taal fr.be— België, EUR, talen nl, fr, en.nl— Nederland, EUR, talen nl, en.dk— Denemarken, DKK, taal da.se— Zweden, SEK, talen sv, en.no— Noorwegen, NOK, talen no, en.fi— Finland, EUR, talen fi, sv, en.ee— Estland, EUR, talen et, ru, en.lv— Letland, EUR, talen lv, ru, en.lt— Litouwen, EUR, talen lt, ru, en.pl— Polen, PLN, taal pl.cz— Tsjechië, CZK, talen cs, en.sk— Slowakije, EUR, taal sk.hu— Hongarije, HUF, taal hu.hr— Kroatië, EUR, taal hr.si— Slovenië, EUR, taal sl.rs— Servië, RSD, taal sr.ro— Roemenië, RON, taal ro.pt— Portugal, EUR, talen pt, en.es— Spanje, EUR, talen es, en, ca, eu, gl.it— Italië, EUR, taal it.il— Israël, ILS, taal he.ae— Verenigde Arabische Emiraten, AED, talen ar, en.sa— Saoedi-Arabië, SAR, talen ar, en.kw— Koeweit, KWD, talen ar, en.qa— Qatar, QAR, talen ar, en.bh— Bahrein, BHD, talen ar, en.om— Oman, OMR, talen ar, en.jo— Jordanië, JOD, talen ar, en.eg— Egypte, EGP, talen ar, en.ma— Marokko, MAD, talen ar, fr, en.in— India, INR, taal en.my— Maleisië, MYR, talen ms, en.sg— Singapore, SGD, taal en.ph— Filipijnen, PHP, taal en.th— Thailand, THB, talen th, en.jp— Japan, JPY, talen ja, en.kr— Zuid-Korea, KRW, talen ko, en.au— Australië, AUD, taal en.nz— Nieuw-Zeeland, NZD, taal en.mx— Mexico, MXN, talen es, en.cl— Chili, CLP, taal es.co— Colombia, COP, taal es.cn— China (ikea.cn), CNY, talen zh, en.pr— Puerto Rico, USD, talen en, es.do— Dominicaanse Republiek, DOP, talen es, en.es_islands— Canarische en Balearische Eilanden (met island), EUR, talen es, en.is— IJsland, ISK, talen en, is.
languagestringDe taal van het antwoord, een die de site van de markt aanbiedt; standaard de eerste van de markt (nl op nl en be, en op us, de op de). Meertalige markten: us en/es, ca en/fr, de en 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, de Golf- en Arabische markten 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 en es_islands es/en, is en/is. Alle andere markten hebben één taal. Een andere code geeft een 400.
Example: fr
islandenum<string>Verplicht met country es_islands (de winkels op de Canarische en Balearische Eilanden), anders niet toegestaan: de winkel van welk eiland.
Example: tenerife
tenerife— Tenerife (Canarische Eilanden).grancanaria— Gran Canaria (Canarische Eilanden).lanzarote— Lanzarote (Canarische Eilanden).fuerteventura— Fuerteventura (Canarische Eilanden).lapalma— La Palma (Canarische Eilanden).lagomera— La Gomera (Canarische Eilanden).elhierro— El Hierro (Canarische Eilanden).mallorca— Mallorca (Balearen).menorca— Menorca (Balearen).ibiza— Ibiza (Balearen).
category_idstring | string[]Beperk tot categorie-id('s) uit de facetten (parameter f-subcategories), bijv. st002.
Example: st002
pageintegerdefault:1Resultaatpagina, vanaf 1. IKEA levert de eerste 2.000 resultaten van een lijst plus één pagina, dus (page - 1) x page_size mag niet boven 2.000 komen.
Example: 2
page_sizeintegerdefault:24Producten per pagina, 1-100.
Example: 48
sortenum<string>default:relevanceVolgorde van de resultaten.
Example: price_asc
relevance— De volgorde van de site. De standaardwaarde.price_asc— Goedkoopste eerst.price_desc— Duurste eerst.newest— Nieuwste producten eerst.rating— Best beoordeeld eerst.name_asc— Naam A tot Z.most_popular— Populairste eerst.
colorstring | string[]Kleur-id('s) uit de facetten (parameter f-colors), bijv. 10156 = wit.
Example: 10156
price_bucketstringEen prijsklasse-id uit de facetten (parameter f-price-buckets), bijv. PRICE_0_5000 = 0 tot 49,99 in de valuta van de markt.
Example: PRICE_0_5000
new_onlybooleanAlleen nieuwe producten.
Example: true
last_chancebooleanAlleen producten met laatste kans (gaan uit het assortiment).
Example: true
family_pricebooleanAlleen producten met een IKEA Family-prijs.
Example: true
top_sellerbooleanAlleen bestsellers.
Example: true
store_idstring | integerEen winkel-id (stores[].store_id van het stores-endpoint). Voegt de beschikbaarheid van elk product in die winkel toe (voorraadniveau, thuisbezorging) en activeert availability.
Example: 088
availabilityenum<string>Met store_id: in_store (op voorraad in de winkel, standaard), click_collect of online.
Example: in_store
in_store— Op voorraad in de winkel.click_collect— Beschikbaar voor click & collect in de winkel.online— Online beschikbaar.
filtersobjectElk ander facet, met facets[].parameter als sleutel, bijv. {"f-materials": ["47350"]}. Booleaanse facetten nemen true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX bij IKEA Nederland, goedkoopste eerst. Prijzen in euro; previous_price
# staat bij artikelen met een nieuwe lagere prijs.
r = client.ikea.search(query="kallax", country="nl", sort="price_asc")["data"]
print(r["total"], "resultaten,", 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