IKEA
IKEA Category API
De producten van één IKEA-categorie op categorie-id of categorie-URL, met dezelfde sorteringen en filters als search: artikelnummer, naam, type, uitvoering, prijs en oude prijs in de valuta van de markt, prijslabel, beoordeling, varianten en categoriepad per product, plus de categorie (id, name, url, parents), total en facetten. 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/jsoncategory_idstringEen categorie-id: categories[].id van het categories-endpoint, of een category_path- / facet-id van een zoekopdracht, bijv. 10382 = boekenkasten op IKEA VS en Duitsland. Stuur category_id of url.
Example: 10382
urlstringEen IKEA-categoriepagina, als alternatief voor category_id; markt en taal worden eruit gelezen.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
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")
# Zoek eerst de categorie-id op IKEA Nederland, en lijst dan de producten, goedkoopste eerst.
tree = client.ikea.categories(country="nl", parent_id="st001")["data"]
cat_id = tree["categories"][0]["id"]
r = client.ikea.category(category_id=cat_id, country="nl", 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