IKEA
IKEA Search API
Meklē IKEA preces pēc atslēgvārda jebkurā no 55 tirgiem: 50 ikea.com tirgi un Ķīna (ikea.cn) atgriež pilnu rezultātu režģi, pēc noklusējuma 24 preces lapā (līdz 100), ar septiņām kārtošanas iespējām un filtriem pēc krāsas, cenu diapazona, kategorijas, jaunām precēm, pēdējās iespējas, IKEA Family cenas, populārākajām precēm, pieejamības veikalā vai jebkuras fasetes. Katrai precei ir artikula numurs, nosaukums, tips, dizains, cena un iepriekšējā cena tirgus valūtā, cenu zīme (jaunā zemākā cena, IKEA Family cena ...), vērtējums, varianti un kategoriju ceļš, kā arī fasetes, did-you-mean, saistītie meklējumi un satura kartītes. Franšīzes vietnes (Puertoriko, Dominikānas Republika, Kanāriju un Baleāru salas, Islande) pieņem tikai query un page. 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/jsonquerystringrequiredMeklēšanas vārdi, 1-200 rakstzīmes, jebkurā tirgus piedāvātajā valodā. Der arī artikula numurs.
Example: kallax
countrystringdefault:usIKEA tirgus kā kods ar mazajiem burtiem. Šis endpoint apkalpo 55 tirgus: 50 ikea.com tirgus, Ķīnu (ikea.cn), Puertoriko, Dominikānas Republiku, Kanāriju un Baleāru salas un Islandi. 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.pr— Puertoriko, USD, valodas en, es.do— Dominikānas Republika, DOP, valodas es, en.es_islands— Kanāriju un Baleāru salas (sūtiet island), EUR, valodas es, en.is— Islande, ISK, valodas en, is.
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
islandenum<string>Obligāts kopā ar country es_islands (Kanāriju un Baleāru salu veikali), citādi nav atļauts: kuras salas veikals.
Example: tenerife
tenerife— Tenerife (Canary Islands).grancanaria— Gran Canaria (Canary Islands).lanzarote— Lanzarote (Canary Islands).fuerteventura— Fuerteventura (Canary Islands).lapalma— La Palma (Canary Islands).lagomera— La Gomera (Canary Islands).elhierro— El Hierro (Canary Islands).mallorca— Mallorca (Balearic Islands).menorca— Menorca (Balearic Islands).ibiza— Ibiza (Balearic Islands).
category_idstring | string[]Sašaurini pēc kategorijas id no fasetēm (parametrs f-subcategories), piem., st002.
Example: st002
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")
# KALLAX ikea.lv, lētākās vispirms. Cenas ir eiro.
r = client.ikea.search(query="kallax", country="lv", language="lv", sort="price_asc")["data"]
print(r["total"], "rezultāti,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["measure_text"], i["price"])Response