IKEA
API wyszukiwania IKEA
Szukaj produktów IKEA po słowach kluczowych na dowolnym z 55 rynków: 50 rynków ikea.com, w tym IKEA Polska, oraz Chiny (ikea.cn) zwracają pełną siatkę wyników, domyślnie 24 produkty na stronę (do 100), z siedmioma sposobami sortowania i filtrami koloru, przedziału cenowego, kategorii, nowości, ostatniej szansy, ceny IKEA Family, bestsellerów, dostępności w sklepie lub dowolnej fasety. Każdy produkt ma numer artykułu, nazwę, typ, wzór, cenę i poprzednią cenę w walucie rynku, etykietę ceny ("Nowa, niższa cena", cena IKEA Family ...), ocenę, warianty i ścieżkę kategorii, a do tego fasety, podpowiedzi poprawek, powiązane wyszukiwania i karty treści. Sklepy franczyzowe (Portoryko, Dominikana, Wyspy Kanaryjskie i Baleary, Islandia) przyjmują tylko query i page. Koszt: 1 kredyt za zapytanie.
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/jsonquerystringrequiredSłowa kluczowe, 1-200 znaków, w dowolnym języku obsługiwanym przez rynek. Działa też numer artykułu.
Example: kallax
countrystringdefault:usRynek IKEA jako kod pisany małymi literami. Ten endpoint obsługuje 55 rynków: 50 rynków ikea.com, Chiny (ikea.cn), Portoryko, Dominikanę, Wyspy Kanaryjskie i Baleary oraz Islandię. Nazwy, opisy i etykiety wracają w języku rynku, a ceny w jego walucie, nigdy nie są przeliczane; odpowiedź powtarza country, language i currency. Rynek spoza tej listy zwraca 400, zanim cokolwiek zostanie naliczone.
Example: pl
us— Stany Zjednoczone, USD, języki en, es. Wartość domyślna.ca— Kanada, CAD, języki en, fr.gb— Wielka Brytania, GBP, język en.ie— Irlandia, EUR, język en.de— Niemcy, EUR, języki de, en.at— Austria, EUR, języki de, en.ch— Szwajcaria, CHF, języki de, fr, it, en.fr— Francja, EUR, język fr.be— Belgia, EUR, języki nl, fr, en.nl— Holandia, EUR, języki nl, en.dk— Dania, DKK, język da.se— Szwecja, SEK, języki sv, en.no— Norwegia, NOK, języki no, en.fi— Finlandia, EUR, języki fi, sv, en.ee— Estonia, EUR, języki et, ru, en.lv— Łotwa, EUR, języki lv, ru, en.lt— Litwa, EUR, języki lt, ru, en.pl— Polska, PLN, język pl.cz— Czechy, CZK, języki cs, en.sk— Słowacja, EUR, język sk.hu— Węgry, HUF, język hu.hr— Chorwacja, EUR, język hr.si— Słowenia, EUR, język sl.rs— Serbia, RSD, język sr.ro— Rumunia, RON, język ro.pt— Portugalia, EUR, języki pt, en.es— Hiszpania, EUR, języki es, en, ca, eu, gl.it— Włochy, EUR, język it.il— Izrael, ILS, język he.ae— Zjednoczone Emiraty Arabskie, AED, języki ar, en.sa— Arabia Saudyjska, SAR, języki ar, en.kw— Kuwejt, KWD, języki ar, en.qa— Katar, QAR, języki ar, en.bh— Bahrajn, BHD, języki ar, en.om— Oman, OMR, języki ar, en.jo— Jordania, JOD, języki ar, en.eg— Egipt, EGP, języki ar, en.ma— Maroko, MAD, języki ar, fr, en.in— Indie, INR, język en.my— Malezja, MYR, języki ms, en.sg— Singapur, SGD, język en.ph— Filipiny, PHP, język en.th— Tajlandia, THB, języki th, en.jp— Japonia, JPY, języki ja, en.kr— Korea Południowa, KRW, języki ko, en.au— Australia, AUD, język en.nz— Nowa Zelandia, NZD, język en.mx— Meksyk, MXN, języki es, en.cl— Chile, CLP, język es.co— Kolumbia, COP, język es.cn— Chiny (ikea.cn), CNY, języki zh, en.pr— Portoryko, USD, języki en, es.do— Dominikana, DOP, języki es, en.es_islands— Wyspy Kanaryjskie i Baleary (podaj island), EUR, języki es, en.is— Islandia, ISK, języki en, is.
languagestringJęzyk odpowiedzi, jeden z tych, które obsługuje strona rynku; domyślnie pierwszy (pl na pl, en na us, de na de). IKEA Polska ma jeden język, polski. Rynki z kilkoma językami: us en/es, ca en/fr, de i 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, rynki Zatoki Perskiej i arabskie 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 i es_islands es/en, is en/is. Pozostałe mają jeden język. Inny kod zwraca 400.
Example: pl
islandenum<string>Wymagane przy country es_islands (sklepy internetowe Wysp Kanaryjskich i Balearów), niedozwolone w innych przypadkach: wyspa, której sklep jest odpytywany.
Example: tenerife
tenerife— Teneryfa (Wyspy Kanaryjskie).grancanaria— Gran Canaria (Wyspy Kanaryjskie).lanzarote— Lanzarote (Wyspy Kanaryjskie).fuerteventura— Fuerteventura (Wyspy Kanaryjskie).lapalma— La Palma (Wyspy Kanaryjskie).lagomera— La Gomera (Wyspy Kanaryjskie).elhierro— El Hierro (Wyspy Kanaryjskie).mallorca— Majorka (Baleary).menorca— Minorka (Baleary).ibiza— Ibiza (Baleary).
category_idstring | string[]Zawęża do ID kategorii z faset (parametr f-subcategories), np. st002.
Example: st002
pageintegerdefault:1Strona wyników, od 1. IKEA udostępnia pierwsze 2000 wyników listy plus jedną stronę, więc (page - 1) x page_size nie może przekroczyć 2000.
Example: 2
page_sizeintegerdefault:24Produkty na stronę, 1-100.
Example: 48
sortenum<string>default:relevanceKolejność wyników.
Example: price_asc
relevance— Kolejność samej strony. Wartość domyślna.price_asc— Od najtańszych.price_desc— Od najdroższych.newest— Od najnowszych.rating— Od najlepiej ocenianych.name_asc— Nazwa od A do Z.most_popular— Od najpopularniejszych.
colorstring | string[]ID koloru z faset (parametr f-colors), np. 10156 = biały.
Example: 10156
price_bucketstringID przedziału cenowego z faset (parametr f-price-buckets), np. PRICE_0_5000 = od 0 do 49,99 w walucie rynku.
Example: PRICE_0_5000
new_onlybooleanTylko nowości.
Example: true
last_chancebooleanTylko produkty z oznaczeniem ostatnia szansa (wycofywane).
Example: true
family_pricebooleanTylko produkty z ceną IKEA Family.
Example: true
top_sellerbooleanTylko bestsellery.
Example: true
store_idstring | integerID sklepu (stores[].store_id z endpointu sklepów). Dodaje dostępność każdego produktu w tym sklepie (poziom zapasu, dostawa do domu) i włącza availability.
Example: 399
availabilityenum<string>Ze store_id: in_store (dostępny w sklepie, domyślnie), click_collect lub online.
Example: in_store
in_store— Dostępny w sklepie.click_collect— Dostępny do odbioru w sklepie (click & collect).online— Dostępny online.
filtersobjectDowolna inna faseta, z kluczem z facets[].parameter, np. {"f-materials": ["47350"]}. Fasety logiczne przyjmują true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX w IKEA Polska, od najtańszych. Ceny w PLN; previous_price
# mają artykuły z etykietą "Nowa, niższa cena".
r = client.ikea.search(query="kallax", country="pl", sort="price_asc")["data"]
print(r["total"], "wyników,", 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