IKEA
IKEA Search API
Caută produse IKEA după cuvânt-cheie pe oricare din cele 55 de piețe: cele 50 de piețe ikea.com și China (ikea.cn) returnează grila completă, implicit 24 de produse pe pagină (până la 100), cu șapte sortări și filtre pentru culoare, interval de preț, categorie, produse noi, „ultima șansă”, preț IKEA Family, cele mai vândute, disponibilitate în magazin sau orice fațetă. Fiecare produs are numărul de articol, numele, tipul, designul, prețul și prețul anterior în moneda pieței, eticheta de preț (preț nou mai mic, preț IKEA Family ...), evaluarea, variantele și calea de categorii, plus fațete, did-you-mean, căutări înrudite și carduri de conținut. Site-urile francizate (Puerto Rico, Republica Dominicană, Insulele Canare și Baleare, Islanda) primesc doar query și page. Costă 1 credit per cerere.
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/jsonquerystringrequiredCuvinte de căutare, 1-200 de caractere, în orice limbă oferită de piață. Funcționează și un număr de articol.
Example: kallax
countrystringdefault:usPiața IKEA, ca cod cu litere mici. Acest endpoint servește 55 de piețe: cele 50 de piețe ikea.com, China (ikea.cn), Puerto Rico, Republica Dominicană, Insulele Canare și Baleare și Islanda. Numele, descrierile și etichetele vin în limba pieței, iar prețurile în moneda ei, niciodată convertite; răspunsul repetă country, language și currency. O piață din afara listei răspunde 400 înainte să se taxeze ceva.
Example: ro
us— Statele Unite, USD, limbi en, es. Implicit.ca— Canada, CAD, limbi en, fr.gb— Regatul Unit, GBP, limba en.ie— Irlanda, EUR, limba en.de— Germania, EUR, limbi de, en.at— Austria, EUR, limbi de, en.ch— Elveția, CHF, limbi de, fr, it, en.fr— Franța, EUR, limba fr.be— Belgia, EUR, limbi nl, fr, en.nl— Țările de Jos, EUR, limbi nl, en.dk— Danemarca, DKK, limba da.se— Suedia, SEK, limbi sv, en.no— Norvegia, NOK, limbi no, en.fi— Finlanda, EUR, limbi fi, sv, en.ee— Estonia, EUR, limbi et, ru, en.lv— Letonia, EUR, limbi lv, ru, en.lt— Lituania, EUR, limbi lt, ru, en.pl— Polonia, PLN, limba pl.cz— Cehia, CZK, limbi cs, en.sk— Slovacia, EUR, limba sk.hu— Ungaria, HUF, limba hu.hr— Croația, EUR, limba hr.si— Slovenia, EUR, limba sl.rs— Serbia, RSD, limba sr.ro— România, RON, limba ro.pt— Portugalia, EUR, limbi pt, en.es— Spania, EUR, limbi es, en, ca, eu, gl.it— Italia, EUR, limba it.il— Israel, ILS, limba he.ae— Emiratele Arabe Unite, AED, limbi ar, en.sa— Arabia Saudită, SAR, limbi ar, en.kw— Kuweit, KWD, limbi ar, en.qa— Qatar, QAR, limbi ar, en.bh— Bahrain, BHD, limbi ar, en.om— Oman, OMR, limbi ar, en.jo— Iordania, JOD, limbi ar, en.eg— Egipt, EGP, limbi ar, en.ma— Maroc, MAD, limbi ar, fr, en.in— India, INR, limba en.my— Malaysia, MYR, limbi ms, en.sg— Singapore, SGD, limba en.ph— Filipine, PHP, limba en.th— Thailanda, THB, limbi th, en.jp— Japonia, JPY, limbi ja, en.kr— Coreea de Sud, KRW, limbi ko, en.au— Australia, AUD, limba en.nz— Noua Zeelandă, NZD, limba en.mx— Mexic, MXN, limbi es, en.cl— Chile, CLP, limba es.co— Columbia, COP, limba es.cn— China (ikea.cn), CNY, limbi zh, en.pr— Puerto Rico, USD, limbi en, es.do— Republica Dominicană, DOP, limbi es, en.es_islands— Insulele Canare și Baleare (trimiteți island), EUR, limbi es, en.is— Islanda, ISK, limbi en, is.
languagestringLimba răspunsului, una dintre cele oferite de site-ul pieței; implicit prima limbă a pieței (ro pe ro, en pe us, de pe de). ikea.ro are o singură limbă, româna. Piețe cu mai multe limbi: 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, piețele din Golf și cele arabe 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. Celelalte piețe au o singură limbă. Alt cod răspunde 400.
Example: ro
islandenum<string>Obligatoriu cu country es_islands (magazinele online din Insulele Canare și Baleare), interzis în rest: magazinul cărei insule.
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[]Restrânge la id-uri de categorie din fațete (parametrul f-subcategories), de ex. st002.
Example: st002
pageintegerdefault:1Pagina de rezultate, de la 1. IKEA servește primele 2.000 de rezultate ale unei liste plus o pagină, deci (page - 1) x page_size nu poate depăși 2.000.
Example: 2
page_sizeintegerdefault:24Produse pe pagină, 1-100.
Example: 48
sortenum<string>default:relevanceOrdinea rezultatelor.
Example: price_asc
relevance— Ordinea site-ului. Implicit.price_asc— Cele mai ieftine primele.price_desc— Cele mai scumpe primele.newest— Cele mai noi produse primele.rating— Cele mai bine evaluate primele.name_asc— Nume de la A la Z.most_popular— Cele mai populare primele.
colorstring | string[]Id-uri de culoare din fațete (parametrul f-colors), de ex. 10156 = alb.
Example: 10156
price_bucketstringId de interval de preț din fațete (parametrul f-price-buckets), de ex. PRICE_0_5000 = 0 - 49.99 în moneda pieței.
Example: PRICE_0_5000
new_onlybooleanDoar produse noi.
Example: true
last_chancebooleanDoar produse „ultima șansă” (ies din ofertă).
Example: true
family_pricebooleanDoar produse cu preț IKEA Family pentru membri.
Example: true
top_sellerbooleanDoar cele mai vândute produse.
Example: true
store_idstring | integerId de magazin (stores[].store_id de la endpointul stores). Adaugă disponibilitatea fiecărui produs în acel magazin (nivel de stoc, livrare la domiciliu) și activează availability.
Example: 399
availabilityenum<string>Cu store_id: in_store (în stoc în magazin, implicit), click_collect sau online.
Example: in_store
in_store— În stoc în magazin.click_collect— Disponibil pentru ridicare din magazin (click and collect).online— Disponibil online.
filtersobjectOrice altă fațetă, cu cheia facets[].parameter, de ex. {"f-materials": ["47350"]}. Fațetele booleene primesc true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX pe ikea.ro, cele mai ieftine primele. Prețuri în RON; previous_price
# apare la produsele cu preț nou mai mic.
r = client.ikea.search(query="kallax", country="ro", sort="price_asc")["data"]
print(r["total"], "rezultate,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"], i["previous_price"], i["price_tag"])Response