IKEA
API di ricerca IKEA
Cerca prodotti IKEA per parola chiave su uno dei 55 mercati: i 50 mercati ikea.com e la Cina (ikea.cn) restituiscono la griglia completa, 24 prodotti per pagina per impostazione predefinita (fino a 100), con sette ordinamenti e filtri per colore, fascia di prezzo, categoria, novità, ultima occasione, prezzo IKEA Family, più venduti, disponibilità in negozio o qualsiasi altro facet. Ogni prodotto riporta codice articolo, nome, tipo, design, prezzo e prezzo precedente nella valuta del mercato, etichetta di prezzo (nuovo prezzo più basso, prezzo IKEA Family ...), valutazione, varianti e percorso di categoria, più i facet, il « forse cercavi », le ricerche correlate e le schede di contenuto. I siti in franchising (Porto Rico, Repubblica Dominicana, Canarie e Baleari, Islanda) accettano solo query e page. Costa 1 credito per richiesta.
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/jsonquerystringrequiredParole chiave, da 1 a 200 caratteri, in una lingua del mercato. Funziona anche un codice articolo.
Example: kallax
countrystringdefault:usIl mercato IKEA, come codice minuscolo (us per impostazione predefinita). Questo endpoint copre 55 mercati: i 50 mercati ikea.com, la Cina (ikea.cn), Porto Rico, la Repubblica Dominicana, le Canarie e le Baleari e l'Islanda. Nomi, descrizioni ed etichette arrivano nella lingua del mercato e i prezzi nella sua valuta, mai convertiti; la risposta riporta country, language e currency. Un mercato fuori da questa lista risponde 400 prima di qualsiasi addebito.
Example: it
us— Stati Uniti, USD, lingue en, es. Valore predefinito.ca— Canada, CAD, lingue en, fr.gb— Regno Unito, GBP, lingua en.ie— Irlanda, EUR, lingua en.de— Germania, EUR, lingue de, en.at— Austria, EUR, lingue de, en.ch— Svizzera, CHF, lingue de, fr, it, en.fr— Francia, EUR, lingua fr.be— Belgio, EUR, lingue nl, fr, en.nl— Paesi Bassi, EUR, lingue nl, en.dk— Danimarca, DKK, lingua da.se— Svezia, SEK, lingue sv, en.no— Norvegia, NOK, lingue no, en.fi— Finlandia, EUR, lingue fi, sv, en.ee— Estonia, EUR, lingue et, ru, en.lv— Lettonia, EUR, lingue lv, ru, en.lt— Lituania, EUR, lingue lt, ru, en.pl— Polonia, PLN, lingua pl.cz— Repubblica Ceca, CZK, lingue cs, en.sk— Slovacchia, EUR, lingua sk.hu— Ungheria, HUF, lingua hu.hr— Croazia, EUR, lingua hr.si— Slovenia, EUR, lingua sl.rs— Serbia, RSD, lingua sr.ro— Romania, RON, lingua ro.pt— Portogallo, EUR, lingue pt, en.es— Spagna, EUR, lingue es, en, ca, eu, gl.it— Italia, EUR, lingua it.il— Israele, ILS, lingua he.ae— Emirati Arabi Uniti, AED, lingue ar, en.sa— Arabia Saudita, SAR, lingue ar, en.kw— Kuwait, KWD, lingue ar, en.qa— Qatar, QAR, lingue ar, en.bh— Bahrein, BHD, lingue ar, en.om— Oman, OMR, lingue ar, en.jo— Giordania, JOD, lingue ar, en.eg— Egitto, EGP, lingue ar, en.ma— Marocco, MAD, lingue ar, fr, en.in— India, INR, lingua en.my— Malesia, MYR, lingue ms, en.sg— Singapore, SGD, lingua en.ph— Filippine, PHP, lingua en.th— Thailandia, THB, lingue th, en.jp— Giappone, JPY, lingue ja, en.kr— Corea del Sud, KRW, lingue ko, en.au— Australia, AUD, lingua en.nz— Nuova Zelanda, NZD, lingua en.mx— Messico, MXN, lingue es, en.cl— Cile, CLP, lingua es.co— Colombia, COP, lingua es.cn— Cina (ikea.cn), CNY, lingue zh, en.pr— Porto Rico, USD, lingue en, es.do— Repubblica Dominicana, DOP, lingue es, en.es_islands— Canarie e Baleari (con island), EUR, lingue es, en.is— Islanda, ISK, lingue en, is.
languagestringLa lingua della risposta, tra quelle del sito del mercato; per impostazione predefinita la prima (en su us, de su de, it su it). Mercati multilingue: us en/es, ca en/fr, de e 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, i mercati del Golfo e arabi 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 ed es_islands es/en, is en/is. Gli altri mercati hanno una sola lingua. Un altro codice risponde 400. Per l'italiano fuori dall'Italia: ch con "language": "it".
Example: it
islandenum<string>Obbligatorio con country es_islands (i negozi online delle Canarie e delle Baleari), non ammesso altrimenti: il negozio di quale isola.
Example: tenerife
tenerife— Tenerife (Canarie).grancanaria— Gran Canaria (Canarie).lanzarote— Lanzarote (Canarie).fuerteventura— Fuerteventura (Canarie).lapalma— La Palma (Canarie).lagomera— La Gomera (Canarie).elhierro— El Hierro (Canarie).mallorca— Maiorca (Baleari).menorca— Minorca (Baleari).ibiza— Ibiza (Baleari).
category_idstring | string[]Limita agli id di categoria dai facet (parametro f-subcategories), per es. st002.
Example: st002
pageintegerdefault:1Pagina dei risultati, a partire da 1. IKEA serve i primi 2.000 risultati di una lista più una pagina: (page - 1) x page_size non può superare 2.000.
Example: 2
page_sizeintegerdefault:24Prodotti per pagina, da 1 a 100.
Example: 48
sortenum<string>default:relevanceOrdine dei risultati.
Example: price_asc
relevance— L'ordine del sito. Predefinito.price_asc— Dal meno caro al più caro.price_desc— Dal più caro al meno caro.newest— Prima le novità.rating— Prima i meglio valutati.name_asc— Nome dalla A alla Z.most_popular— Prima i più popolari.
colorstring | string[]Id colore dai facet (parametro f-colors), per es. 10156 = bianco.
Example: 10156
price_bucketstringUn id di fascia di prezzo dai facet (parametro f-price-buckets), per es. PRICE_0_2000 = da 0,00 a 19,99 € su it.
Example: PRICE_0_5000
new_onlybooleanSolo le novità.
Example: true
last_chancebooleanSolo i prodotti ultima occasione (fuori produzione).
Example: true
family_pricebooleanSolo i prodotti con un prezzo IKEA Family.
Example: true
top_sellerbooleanSolo i più venduti.
Example: true
store_idstring | integerUn id negozio (stores[].store_id dell'endpoint stores). Aggiunge la disponibilità di ogni prodotto in quel negozio (livello di disponibilità, consegna a domicilio) e attiva availability.
Example: 399
availabilityenum<string>Con store_id: in_store (disponibile nel negozio, predefinito), click_collect oppure online.
Example: in_store
in_store— Disponibile nel negozio.click_collect— Disponibile con click and collect nel negozio.online— Disponibile online.
filtersobjectQualsiasi altro facet, con la chiave facets[].parameter, per es. {"f-materials": ["47350"]}. I facet booleani accettano true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX in Italia, dal meno caro al più caro. Prezzi in EUR; previous_price
# è presente sugli articoli a nuovo prezzo più basso.
r = client.ikea.search(query="kallax", country="it", sort="price_asc")["data"]
print(r["total"], "risultati,", 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