IKEA
API categoria IKEA
I prodotti di una categoria IKEA per id o URL di categoria, con gli stessi ordinamenti e filtri della ricerca: codice articolo, nome, tipo, design, prezzo e prezzo precedente nella valuta del mercato, etichetta di prezzo, valutazione, varianti e percorso di categoria di ogni prodotto, più la categoria (id, name, url, parents), il totale e i facet. Sui 50 mercati ikea.com e in Cina (ikea.cn). 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/jsoncategory_idstringUn id di categoria: categories[].id dell'endpoint categories, o un id di category_path / facet di una ricerca, per es. st002 = « Librerie e scaffali » su it. Invia category_id oppure url.
Example: st002
urlstringUna pagina di categoria IKEA, in alternativa a category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usIl mercato IKEA, come codice minuscolo (us per impostazione predefinita). Questo endpoint copre 51 mercati: i 50 mercati ikea.com e la Cina (ikea.cn). 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.
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
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")
# Librerie e scaffali in Italia, dal meno caro, 48 per pagina.
r = client.ikea.category(category_id="st002", country="it", 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