IKEA
IKEA Category API
Produsele unei categorii IKEA după id-ul categoriei sau URL-ul paginii de categorie, cu aceleași sortări și filtre ca la căutare: pentru fiecare produs numărul de articol, numele, tipul, designul, prețul și prețul anterior în moneda pieței, eticheta de preț, evaluarea, variantele și calea de categorii, plus categoria (id, nume, url, părinți), total și fațete. Pe cele 50 de piețe ikea.com și China (ikea.cn). 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/jsoncategory_idstringUn id de categorie: categories[].id de la endpointul categories sau un id din category_path / fațetele unei căutări, de ex. 11465 = Etajere pe ikea.ro. Trimiteți category_id sau url.
Example: 11465
urlstringO pagină de categorie IKEA, în locul lui category_id.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usPiața IKEA, ca cod cu litere mici. Acest endpoint servește 51 de piețe: cele 50 de piețe ikea.com și China (ikea.cn). 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.
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
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")
# Etajere pe ikea.ro (categoria 11465), cele mai ieftine primele, 48 pe pagină.
r = client.ikea.category(category_id="11465", country="ro", 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"], i["previous_price"])Response