IKEA
API promocji IKEA
Jedna z list promocji IKEA danego rynku: nowe, niższe ceny, ceny IKEA Family, ostatnia szansa (produkty wycofywane), nowości, asortyment w najniższej cenie, bestsellery, edycje limitowane, oferty ograniczone czasowo, ceny tylko w sklepie i oferty z obniżoną ceną. Każdy produkt ma cenę i poprzednią cenę w walucie rynku, etykietę ceny i daty obowiązywania ceny, z tym samym sortowaniem i filtrami co wyszukiwanie. Na 50 rynkach ikea.com i w Chinach (ikea.cn). 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/jsontypeenum<string>requiredKtóra lista promocji.
Example: new_lower_price
new_products— Nowości.family_price— Ceny IKEA Family: price to cena dla członków, a previous_price cena regularna.new_lower_price— Nowa, niższa cena (tak w IKEA Polska): previous_price to cena sprzed obniżki, z datami obowiązywania nowej ceny.last_chance— Ostatnia szansa: produkty wycofywane z oferty.lowest_price— Asortyment w najniższej cenie.top_seller— Bestsellery.limited_edition— Edycje limitowane.time_restricted— Oferty ograniczone czasowo.in_store_price_only— Ceny obowiązujące tylko w sklepie.reduced_price_offer— Oferty z obniżoną ceną.
countrystringdefault:usRynek IKEA jako kod pisany małymi literami. Ten endpoint obsługuje 51 rynków: 50 rynków ikea.com i Chiny (ikea.cn). 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.
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
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")
# Promocje IKEA Polska: nowe, niższe ceny, od najdroższych, 100 na stronę.
r = client.ikea.deals(type="new_lower_price", country="pl", page_size=100, sort="price_desc")["data"]
print(r["total"], "artykułów z obniżoną ceną w", r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_to"])Response