IKEA
IKEA Such-API
IKEA-Produkte per Stichwort auf einem von 55 Märkten suchen: die 50 ikea.com-Märkte und China (ikea.cn) liefern das volle Raster, standardmäßig 24 Produkte pro Seite (bis 100), mit sieben Sortierungen und Filtern nach Farbe, Preisspanne, Kategorie, neu, letzte Chance, IKEA Family-Preis, Bestseller, Verfügbarkeit im Einrichtungshaus oder jeder Facette. Jedes Produkt hat Artikelnummer, Name, Typ, Design, Preis und Vorpreis in der Währung des Markts, Preisschild (neuer niedrigerer Preis, IKEA Family-Preis ...), Bewertung, Varianten und Kategoriepfad, dazu Facetten, Meinten-Sie-Vorschläge, verwandte Suchen und Inhaltskarten. Die Franchise-Seiten (Puerto Rico, Dominikanische Republik, Kanaren und Balearen, Island) nehmen nur query und page an. Kostet 1 Credit pro Anfrage.
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/jsonquerystringrequiredSuchbegriffe, 1-200 Zeichen, in jeder Sprache, die der Markt anbietet. Auch eine Artikelnummer funktioniert.
Example: kallax
countrystringdefault:usDer IKEA-Markt als Kleinbuchstaben-Code. Dieser Endpoint bedient 55 Märkte: die 50 ikea.com-Märkte, China (ikea.cn), Puerto Rico, die Dominikanische Republik, die Kanaren und Balearen sowie Island. Namen, Beschreibungen und Labels kommen in der Sprache des Markts zurück, Preise in seiner Währung und nie umgerechnet; die Antwort wiederholt country, language und currency. Ein Markt außerhalb dieser Liste antwortet mit 400, bevor etwas berechnet wird. "de" ist IKEA Deutschland, "at" IKEA Österreich, "ch" IKEA Schweiz.
Example: de
us— USA, USD, Sprachen en, es. Standardwert.ca— Kanada, CAD, Sprachen en, fr.gb— Vereinigtes Königreich, GBP, Sprache en.ie— Irland, EUR, Sprache en.de— Deutschland, EUR, Sprachen de, en.at— Österreich, EUR, Sprachen de, en.ch— Schweiz, CHF, Sprachen de, fr, it, en.fr— Frankreich, EUR, Sprache fr.be— Belgien, EUR, Sprachen nl, fr, en.nl— Niederlande, EUR, Sprachen nl, en.dk— Dänemark, DKK, Sprache da.se— Schweden, SEK, Sprachen sv, en.no— Norwegen, NOK, Sprachen no, en.fi— Finnland, EUR, Sprachen fi, sv, en.ee— Estland, EUR, Sprachen et, ru, en.lv— Lettland, EUR, Sprachen lv, ru, en.lt— Litauen, EUR, Sprachen lt, ru, en.pl— Polen, PLN, Sprache pl.cz— Tschechien, CZK, Sprachen cs, en.sk— Slowakei, EUR, Sprache sk.hu— Ungarn, HUF, Sprache hu.hr— Kroatien, EUR, Sprache hr.si— Slowenien, EUR, Sprache sl.rs— Serbien, RSD, Sprache sr.ro— Rumänien, RON, Sprache ro.pt— Portugal, EUR, Sprachen pt, en.es— Spanien, EUR, Sprachen es, en, ca, eu, gl.it— Italien, EUR, Sprache it.il— Israel, ILS, Sprache he.ae— Vereinigte Arabische Emirate, AED, Sprachen ar, en.sa— Saudi-Arabien, SAR, Sprachen ar, en.kw— Kuwait, KWD, Sprachen ar, en.qa— Katar, QAR, Sprachen ar, en.bh— Bahrain, BHD, Sprachen ar, en.om— Oman, OMR, Sprachen ar, en.jo— Jordanien, JOD, Sprachen ar, en.eg— Ägypten, EGP, Sprachen ar, en.ma— Marokko, MAD, Sprachen ar, fr, en.in— Indien, INR, Sprache en.my— Malaysia, MYR, Sprachen ms, en.sg— Singapur, SGD, Sprache en.ph— Philippinen, PHP, Sprache en.th— Thailand, THB, Sprachen th, en.jp— Japan, JPY, Sprachen ja, en.kr— Südkorea, KRW, Sprachen ko, en.au— Australien, AUD, Sprache en.nz— Neuseeland, NZD, Sprache en.mx— Mexiko, MXN, Sprachen es, en.cl— Chile, CLP, Sprache es.co— Kolumbien, COP, Sprache es.cn— China (ikea.cn), CNY, Sprachen zh, en.pr— Puerto Rico, USD, Sprachen en, es.do— Dominikanische Republik, DOP, Sprachen es, en.es_islands— Kanaren und Balearen (mit island), EUR, Sprachen es, en.is— Island, ISK, Sprachen en, is.
languagestringDie Sprache der Antwort, eine, die die Seite des Markts anbietet; Standard ist die erste des Markts (de auf de und at, en auf us, fr auf fr). Mehrsprachige Märkte: us en/es, ca en/fr, de und 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, die Golf- und arabischen Märkte 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 und es_islands es/en, is en/is. Alle anderen Märkte haben eine Sprache. Ein anderer Code antwortet mit 400.
Example: en
islandenum<string>Pflicht mit country es_islands (die Shops der Kanaren und Balearen), sonst nicht erlaubt: der Shop welcher Insel.
Example: tenerife
tenerife— Teneriffa (Kanaren).grancanaria— Gran Canaria (Kanaren).lanzarote— Lanzarote (Kanaren).fuerteventura— Fuerteventura (Kanaren).lapalma— La Palma (Kanaren).lagomera— La Gomera (Kanaren).elhierro— El Hierro (Kanaren).mallorca— Mallorca (Balearen).menorca— Menorca (Balearen).ibiza— Ibiza (Balearen).
category_idstring | string[]Auf Kategorie-ID(s) aus den Facetten eingrenzen (Parameter f-subcategories), z. B. st002.
Example: st002
pageintegerdefault:1Ergebnisseite, ab 1. IKEA liefert die ersten 2.000 Ergebnisse einer Liste plus eine Seite, daher darf (page - 1) x page_size 2.000 nicht überschreiten.
Example: 2
page_sizeintegerdefault:24Produkte pro Seite, 1-100.
Example: 48
sortenum<string>default:relevanceReihenfolge der Ergebnisse.
Example: price_asc
relevance— Die Reihenfolge der Seite. Standardwert.price_asc— Günstigste zuerst.price_desc— Teuerste zuerst.newest— Neueste Produkte zuerst.rating— Am besten bewertete zuerst.name_asc— Name A bis Z.most_popular— Beliebteste zuerst.
colorstring | string[]Farb-ID(s) aus den Facetten (Parameter f-colors), z. B. 10156 = weiß.
Example: 10156
price_bucketstringEine Preisspannen-ID aus den Facetten (Parameter f-price-buckets), z. B. PRICE_0_5000 = 0 bis 49,99 in der Währung des Markts.
Example: PRICE_0_5000
new_onlybooleanNur neue Produkte.
Example: true
last_chancebooleanNur Produkte der letzten Chance (laufen aus).
Example: true
family_pricebooleanNur Produkte mit IKEA Family-Preis.
Example: true
top_sellerbooleanNur Bestseller.
Example: true
store_idstring | integerEine Einrichtungshaus-ID (stores[].store_id des stores-Endpoints). Ergänzt die Verfügbarkeit jedes Produkts in diesem Einrichtungshaus (Lagerstand, Lieferung nach Hause) und aktiviert availability.
Example: 324
availabilityenum<string>Mit store_id: in_store (vorrätig im Einrichtungshaus, Standard), click_collect oder online.
Example: in_store
in_store— Vorrätig im Einrichtungshaus.click_collect— Für Click & Collect im Einrichtungshaus verfügbar.online— Online verfügbar.
filtersobjectJede andere Facette, mit facets[].parameter als Schlüssel, z. B. {"f-materials": ["47350"]}. Boolesche Facetten nehmen true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX bei IKEA Deutschland, günstigste zuerst. Preise in EUR; previous_price
# ist bei Artikeln mit neuem niedrigeren Preis gesetzt.
r = client.ikea.search(query="kallax", country="de", sort="price_asc")["data"]
print(r["total"], "Treffer,", 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