IKEA
IKEA aanbiedingen API
Een van de aanbiedingslijsten van een IKEA-markt: nieuwe lagere prijzen, IKEA Family-ledenprijzen, laatste kans (gaat uit het assortiment), nieuwe producten, het laagsteprijsassortiment, bestsellers, gelimiteerde edities, tijdelijke, alleen-in-de-winkel- en afgeprijsde aanbiedingen. Elk product heeft prijs en oude prijs in de valuta van de markt, het prijslabel en de geldigheidsdata van de prijs, met dezelfde sorteringen en filters als search. Op de 50 ikea.com-markten en China (ikea.cn). 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/jsontypeenum<string>requiredWelke aanbiedingslijst.
Example: new_lower_price
new_products— Nieuwe producten.family_price— IKEA Family-prijzen: price is de ledenprijs, previous_price de gewone prijs.new_lower_price— Nieuwe lagere prijs: previous_price is de prijs vóór de verlaging, met de geldigheidsdata van de nieuwe prijs.last_chance— Laatste kans: producten die uit het assortiment gaan.lowest_price— Het assortiment met de laagste prijzen.top_seller— Bestsellers.limited_edition— Gelimiteerde edities.time_restricted— Tijdelijke aanbiedingen.in_store_price_only— Prijzen die alleen in de winkel gelden.reduced_price_offer— Afgeprijsde aanbiedingen.
countrystringdefault:usDe IKEA-markt als code in kleine letters. Dit endpoint bedient 51 markten: de 50 ikea.com-markten en China (ikea.cn). 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.
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
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")
# Nieuwe lagere prijzen bij IKEA Nederland, duurste eerst, 100 per pagina.
r = client.ikea.deals(type="new_lower_price", country="nl", page_size=100, sort="price_desc")["data"]
print(r["total"], "artikelen met een nieuwe lagere prijs in", r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_from"])Response