IKEA
IKEA Category API
Vienos IKEA kategorijos prekės pagal kategorijos id arba kategorijos puslapio URL, su tais pačiais rikiavimo būdais ir filtrais kaip paieškoje: kiekvienai prekei prekės numeris, pavadinimas, tipas, dizainas, kaina ir ankstesnė kaina rinkos valiuta, kainos žyma, įvertinimas, variantai ir kategorijų kelias, taip pat kategorija (id, pavadinimas, url, tėvinės kategorijos), total ir facetai. 50 ikea.com rinkų ir Kinijoje (ikea.cn). Kainuoja 1 kreditą už užklausą.
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_idstringKategorijos id: categories endpoint categories[].id arba paieškos category_path / facetų id, pvz. 11465 = lentynos ikea.lt. Siųskite category_id arba url.
Example: 11465
urlstringIKEA kategorijos puslapis vietoj category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usIKEA rinka, nurodoma mažosiomis raidėmis. Šis endpoint aptarnauja 51 rinką: 50 ikea.com rinkų ir Kiniją (ikea.cn). Pavadinimai, aprašymai ir etiketės grąžinami rinkos kalba, o kainos rinkos valiuta, niekada nekonvertuojamos; atsakyme pakartojami country, language ir currency. Rinka, kurios nėra sąraše, grąžina 400 prieš bet kokį apmokestinimą.
Example: lt
us— JAV, USD, kalbos en, es. Numatytoji.ca— Kanada, CAD, kalbos en, fr.gb— Jungtinė Karalystė, GBP, kalba en.ie— Airija, EUR, kalba en.de— Vokietija, EUR, kalbos de, en.at— Austrija, EUR, kalbos de, en.ch— Šveicarija, CHF, kalbos de, fr, it, en.fr— Prancūzija, EUR, kalba fr.be— Belgija, EUR, kalbos nl, fr, en.nl— Nyderlandai, EUR, kalbos nl, en.dk— Danija, DKK, kalba da.se— Švedija, SEK, kalbos sv, en.no— Norvegija, NOK, kalbos no, en.fi— Suomija, EUR, kalbos fi, sv, en.ee— Estija, EUR, kalbos et, ru, en.lv— Latvija, EUR, kalbos lv, ru, en.lt— Lietuva, EUR, kalbos lt, ru, en.pl— Lenkija, PLN, kalba pl.cz— Čekija, CZK, kalbos cs, en.sk— Slovakija, EUR, kalba sk.hu— Vengrija, HUF, kalba hu.hr— Kroatija, EUR, kalba hr.si— Slovėnija, EUR, kalba sl.rs— Serbija, RSD, kalba sr.ro— Rumunija, RON, kalba ro.pt— Portugalija, EUR, kalbos pt, en.es— Ispanija, EUR, kalbos es, en, ca, eu, gl.it— Italija, EUR, kalba it.il— Izraelis, ILS, kalba he.ae— Jungtiniai Arabų Emyratai, AED, kalbos ar, en.sa— Saudo Arabija, SAR, kalbos ar, en.kw— Kuveitas, KWD, kalbos ar, en.qa— Kataras, QAR, kalbos ar, en.bh— Bahreinas, BHD, kalbos ar, en.om— Omanas, OMR, kalbos ar, en.jo— Jordanija, JOD, kalbos ar, en.eg— Egiptas, EGP, kalbos ar, en.ma— Marokas, MAD, kalbos ar, fr, en.in— Indija, INR, kalba en.my— Malaizija, MYR, kalbos ms, en.sg— Singapūras, SGD, kalba en.ph— Filipinai, PHP, kalba en.th— Tailandas, THB, kalbos th, en.jp— Japonija, JPY, kalbos ja, en.kr— Pietų Korėja, KRW, kalbos ko, en.au— Australija, AUD, kalba en.nz— Naujoji Zelandija, NZD, kalba en.mx— Meksika, MXN, kalbos es, en.cl— Čilė, CLP, kalba es.co— Kolumbija, COP, kalba es.cn— Kinija (ikea.cn), CNY, kalbos zh, en.
languagestringAtsakymo kalba, viena iš tų, kurias siūlo rinkos svetainė; numatytoji yra pirmoji rinkos kalba (lt rinkoje lt, us rinkoje en, de rinkoje de). ikea.lt siūlo lt, ru ir en, ikea.lv lv, ru ir en, ikea.ee et, ru ir en. Kitos daugiakalbės rinkos: us en/es, ca en/fr, de ir 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, cz cs/en, pt pt/en, es es/en/ca/eu/gl, Persijos įlankos ir arabų rinkos 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 ir es_islands es/en, is en/is. Visos kitos rinkos turi vieną kalbą. Kitas kodas grąžina 400.
Example: lt
pageintegerdefault:1Rezultatų puslapis, nuo 1. IKEA pateikia pirmus 2 000 sąrašo rezultatų ir dar vieną puslapį, todėl (page - 1) x page_size negali viršyti 2 000.
Example: 2
page_sizeintegerdefault:24Prekių puslapyje, 1-100.
Example: 48
sortenum<string>default:relevanceRezultatų tvarka.
Example: price_asc
relevance— Pačios svetainės tvarka. Numatytoji.price_asc— Pigiausios pirmiau.price_desc— Brangiausios pirmiau.newest— Naujausios prekės pirmiau.rating— Geriausiai įvertintos pirmiau.name_asc— Pavadinimas nuo A iki Z.most_popular— Populiariausios pirmiau.
colorstring | string[]Spalvos id iš facetų (parametras f-colors), pvz. 10156 = balta.
Example: 10156
price_bucketstringKainų intervalo id iš facetų (parametras f-price-buckets), pvz. PRICE_0_5000 = nuo 0 iki 49.99 rinkos valiuta.
Example: PRICE_0_5000
new_onlybooleanTik naujos prekės.
Example: true
last_chancebooleanTik paskutinės progos prekės (išimamos iš prekybos).
Example: true
family_pricebooleanTik prekės su IKEA Family nario kaina.
Example: true
top_sellerbooleanTik perkamiausios prekės.
Example: true
store_idstring | integerParduotuvės id (stores endpoint stores[].store_id). Prideda kiekvienos prekės prieinamumą toje parduotuvėje (likučio lygis, pristatymas į namus) ir įjungia availability.
Example: 399
availabilityenum<string>Su store_id: in_store (yra parduotuvėje, numatytoji), click_collect arba online.
Example: in_store
in_store— Yra parduotuvėje.click_collect— Galima atsiimti parduotuvėje (click and collect).online— Galima įsigyti internetu.
filtersobjectBet kuris kitas facetas, raktas yra facets[].parameter, pvz. {"f-materials": ["47350"]}. Loginiai facetai priima true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Lentynos ikea.lt (kategorija 11465), pigiausios pirmiau, 48 puslapyje.
r = client.ikea.category(category_id="11465", country="lt", 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