IKEA
API kategorii IKEA
Produkty jednej kategorii IKEA po ID lub URL kategorii, z tym samym sortowaniem i filtrami co wyszukiwanie: numer artykułu, nazwa, typ, wzór, cena i poprzednia cena w walucie rynku, etykieta ceny, ocena, warianty i ścieżka kategorii każdego produktu, a także kategoria (id, nazwa, url, kategorie nadrzędne), liczba wyników i fasety. 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/jsoncategory_idstringID kategorii: categories[].id z endpointu kategorii albo ID z category_path / facets wyszukiwania, np. 10382 = regały na książki i fu003 = sofy na us. Podaj category_id lub url.
Example: 10382
urlstringStrona kategorii IKEA, zamiast category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
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")
# Weź ID z drzewa IKEA Polska i pobierz tę kategorię, od najtańszych.
tree = client.ikea.categories(country="pl")["data"]["categories"]
cat_id = tree[0]["id"]
r = client.ikea.category(category_id=cat_id, country="pl", 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