IKEA
IKEA Category API
Vienas IKEA kategorijas preces pēc kategorijas id vai kategorijas lapas URL, ar tām pašām kārtošanas iespējām un filtriem kā meklēšanā: katrai precei artikula numurs, nosaukums, tips, dizains, cena un iepriekšējā cena tirgus valūtā, cenu zīme, vērtējums, varianti un kategoriju ceļš, kā arī kategorija (id, nosaukums, url, vecāki), total un fasetes. 50 ikea.com tirgos un Ķīnā (ikea.cn). Maksā 1 kredītu par pieprasījumu.
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_idstringKategorijas id: categories endpoint categories[].id vai meklējuma category_path / fasetes id, piem., 11465 = Plaukti ikea.lv. Sūti category_id vai url.
Example: 11465
urlstringIKEA kategorijas lapa category_id vietā.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usIKEA tirgus kā kods ar mazajiem burtiem. Šis endpoint apkalpo 51 tirgu: 50 ikea.com tirgus un Ķīnu (ikea.cn). Nosaukumi, apraksti un etiķetes atnāk tirgus valodā un cenas tirgus valūtā, nekad nekonvertētas; atbildē atkārtojas country, language un currency. Tirgus, kura nav sarakstā, atbild ar 400, pirms kaut kas tiek norakstīts.
Example: lv
us— ASV, USD, valodas en, es. Noklusējums.ca— Kanāda, CAD, valodas en, fr.gb— Apvienotā Karaliste, GBP, valoda en.ie— Īrija, EUR, valoda en.de— Vācija, EUR, valodas de, en.at— Austrija, EUR, valodas de, en.ch— Šveice, CHF, valodas de, fr, it, en.fr— Francija, EUR, valoda fr.be— Beļģija, EUR, valodas nl, fr, en.nl— Nīderlande, EUR, valodas nl, en.dk— Dānija, DKK, valoda da.se— Zviedrija, SEK, valodas sv, en.no— Norvēģija, NOK, valodas no, en.fi— Somija, EUR, valodas fi, sv, en.ee— Igaunija, EUR, valodas et, ru, en.lv— Latvija, EUR, valodas lv, ru, en.lt— Lietuva, EUR, valodas lt, ru, en.pl— Polija, PLN, valoda pl.cz— Čehija, CZK, valodas cs, en.sk— Slovākija, EUR, valoda sk.hu— Ungārija, HUF, valoda hu.hr— Horvātija, EUR, valoda hr.si— Slovēnija, EUR, valoda sl.rs— Serbija, RSD, valoda sr.ro— Rumānija, RON, valoda ro.pt— Portugāle, EUR, valodas pt, en.es— Spānija, EUR, valodas es, en, ca, eu, gl.it— Itālija, EUR, valoda it.il— Izraēla, ILS, valoda he.ae— Apvienotie Arābu Emirāti, AED, valodas ar, en.sa— Saūda Arābija, SAR, valodas ar, en.kw— Kuveita, KWD, valodas ar, en.qa— Katara, QAR, valodas ar, en.bh— Bahreina, BHD, valodas ar, en.om— Omāna, OMR, valodas ar, en.jo— Jordānija, JOD, valodas ar, en.eg— Ēģipte, EGP, valodas ar, en.ma— Maroka, MAD, valodas ar, fr, en.in— Indija, INR, valoda en.my— Malaizija, MYR, valodas ms, en.sg— Singapūra, SGD, valoda en.ph— Filipīnas, PHP, valoda en.th— Taizeme, THB, valodas th, en.jp— Japāna, JPY, valodas ja, en.kr— Dienvidkoreja, KRW, valodas ko, en.au— Austrālija, AUD, valoda en.nz— Jaunzēlande, NZD, valoda en.mx— Meksika, MXN, valodas es, en.cl— Čīle, CLP, valoda es.co— Kolumbija, COP, valoda es.cn— Ķīna (ikea.cn), CNY, valodas zh, en.
languagestringAtbildes valoda, viena no tām, ko piedāvā tirgus vietne; noklusējums ir tirgus pirmā valoda (lv tirgū lv, us tirgū en, de tirgū de). ikea.lv piedāvā lv, ru un en, ikea.ee et, ru un en, ikea.lt lt, ru un en. Citi daudzvalodu tirgi: us en/es, ca en/fr, de un 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, Persijas līča un arābu tirgi 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 un es_islands es/en, is en/is. Pārējiem tirgiem ir viena valoda. Cits kods atbild ar 400.
Example: lv
pageintegerdefault:1Rezultātu lapa, sākot no 1. IKEA rāda saraksta pirmos 2000 rezultātus plus vienu lapu, tāpēc (page - 1) x page_size nedrīkst pārsniegt 2000.
Example: 2
page_sizeintegerdefault:24Preces lapā, 1-100.
Example: 48
sortenum<string>default:relevanceRezultātu secība.
Example: price_asc
relevance— Vietnes secība. Noklusējums.price_asc— Lētākās vispirms.price_desc— Dārgākās vispirms.newest— Jaunākās preces vispirms.rating— Ar labāko vērtējumu vispirms.name_asc— Nosaukums no A līdz Z.most_popular— Populārākās vispirms.
colorstring | string[]Krāsas id no fasetēm (parametrs f-colors), piem., 10156 = balta.
Example: 10156
price_bucketstringCenu diapazona id no fasetēm (parametrs f-price-buckets), piem., PRICE_0_5000 = no 0 līdz 49.99 tirgus valūtā.
Example: PRICE_0_5000
new_onlybooleanTikai jaunas preces.
Example: true
last_chancebooleanTikai pēdējās iespējas preces (izņem no sortimenta).
Example: true
family_pricebooleanTikai preces ar IKEA Family biedru cenu.
Example: true
top_sellerbooleanTikai populārākās preces.
Example: true
store_idstring | integerVeikala id (stores endpoint stores[].store_id). Pievieno katras preces pieejamību šajā veikalā (krājumu līmenis, piegāde uz mājām) un ieslēdz availability filtru.
Example: 399
availabilityenum<string>Kopā ar store_id: in_store (ir veikalā, noklusējums), click_collect vai online.
Example: in_store
in_store— Ir krājumā veikalā.click_collect— Pieejams saņemšanai veikalā (click and collect).online— Pieejams tiešsaistē.
filtersobjectJebkura cita fasete, atslēga ir facets[].parameter, piem., {"f-materials": ["47350"]}. Būla fasetes pieņem true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Plaukti ikea.lv (kategorija 11465), lētākie vispirms, 48 lapā.
r = client.ikea.category(category_id="11465", country="lv", 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