IKEA
IKEA Search API - חיפוש מוצרים
חיפוש מוצרי IKEA במילת מפתח בכל אחד מ-55 שווקים: 50 השווקים של ikea.com וסין (ikea.cn) מחזירים את הרשת המלאה, 24 מוצרים בעמוד כברירת מחדל (עד 100), עם שבעה סוגי מיון ומסננים לצבע, טווח מחירים, קטגוריה, חדש, הזדמנות אחרונה, מחיר IKEA Family, רב מכר, זמינות בחנות או כל facet. לכל מוצר מספר, שם, סוג, עיצוב, מחיר ומחיר קודם במטבע השוק, תווית מחיר (מחיר נמוך חדש, מחיר IKEA Family ...), דירוג, וריאנטים ונתיב קטגוריה, ובנוסף facets, did-you-mean, חיפושים קשורים וכרטיסי תוכן. אתרי הזיכיון (פוארטו ריקו, הרפובליקה הדומיניקנית, האיים הקנריים והבלאריים, איסלנד) מקבלים query ו-page בלבד. עלות: קרדיט אחד לבקשה.
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/jsonquerystringrequiredמילות חיפוש, 1-200 תווים, בכל שפה שהשוק מציע ("kallax" או "ספה"). גם מספר מוצר עובד.
Example: kallax
countrystringdefault:usשוק IKEA, כקוד באותיות קטנות. נקודת הקצה הזו משרתת 55 שווקים: 50 השווקים של ikea.com, סין (ikea.cn), פוארטו ריקו, הרפובליקה הדומיניקנית, האיים הקנריים והבלאריים ואיסלנד. שמות, תיאורים ותוויות חוזרים בשפת השוק והמחירים במטבע שלו, בלי המרה; התגובה מחזירה את country, language ו-currency. שוק שאינו ברשימה מחזיר 400 לפני חיוב כלשהו. ישראל: il, בעברית ובשקלים (ILS).
Example: il
us— ארצות הברית, USD, שפות en, es. ברירת המחדל.ca— קנדה, CAD, שפות en, fr.gb— בריטניה, GBP, שפה en.ie— אירלנד, EUR, שפה en.de— גרמניה, EUR, שפות de, en.at— אוסטריה, EUR, שפות de, en.ch— שווייץ, CHF, שפות de, fr, it, en.fr— צרפת, EUR, שפה fr.be— בלגיה, EUR, שפות nl, fr, en.nl— הולנד, EUR, שפות nl, en.dk— דנמרק, DKK, שפה da.se— שוודיה, SEK, שפות sv, en.no— נורווגיה, NOK, שפות no, en.fi— פינלנד, EUR, שפות fi, sv, en.ee— אסטוניה, EUR, שפות et, ru, en.lv— לטביה, EUR, שפות lv, ru, en.lt— ליטא, EUR, שפות lt, ru, en.pl— פולין, PLN, שפה pl.cz— צ׳כיה, CZK, שפות cs, en.sk— סלובקיה, EUR, שפה sk.hu— הונגריה, HUF, שפה hu.hr— קרואטיה, EUR, שפה hr.si— סלובניה, EUR, שפה sl.rs— סרביה, RSD, שפה sr.ro— רומניה, RON, שפה ro.pt— פורטוגל, EUR, שפות pt, en.es— ספרד, EUR, שפות es, en, ca, eu, gl.it— איטליה, EUR, שפה it.il— ישראל, ILS, שפה he.ae— איחוד האמירויות, AED, שפות ar, en.sa— ערב הסעודית, SAR, שפות ar, en.kw— כווית, KWD, שפות ar, en.qa— קטאר, QAR, שפות ar, en.bh— בחריין, BHD, שפות ar, en.om— עומאן, OMR, שפות ar, en.jo— ירדן, JOD, שפות ar, en.eg— מצרים, EGP, שפות ar, en.ma— מרוקו, MAD, שפות ar, fr, en.in— הודו, INR, שפה en.my— מלזיה, MYR, שפות ms, en.sg— סינגפור, SGD, שפה en.ph— הפיליפינים, PHP, שפה en.th— תאילנד, THB, שפות th, en.jp— יפן, JPY, שפות ja, en.kr— דרום קוריאה, KRW, שפות ko, en.au— אוסטרליה, AUD, שפה en.nz— ניו זילנד, NZD, שפה en.mx— מקסיקו, MXN, שפות es, en.cl— צ׳ילה, CLP, שפה es.co— קולומביה, COP, שפה es.cn— סין (ikea.cn), CNY, שפות zh, en.pr— פוארטו ריקו, USD, שפות en, es.do— הרפובליקה הדומיניקנית, DOP, שפות es, en.es_islands— האיים הקנריים והבלאריים (שלחו island), EUR, שפות es, en.is— איסלנד, ISK, שפות en, is.
languagestringשפת התגובה, אחת שאתר השוק מציע; ברירת המחדל היא הראשונה (he ב-il, en ב-us). ב-il יש שפה אחת, עברית. שווקים רב-לשוניים: us en/es, ca en/fr, de ו-at de/en, ch de/fr/it/en, be nl/fr/en, nl nl/en, se sv/en, es es/en/ca/eu/gl, שווקי המפרץ והשווקים הערביים ar/en (ma ar/fr/en), my ms/en, th th/en, jp ja/en, kr ko/en, cn zh/en, is en/is. קוד אחר מחזיר 400. המחיר והמטבע אינם משתנים עם השפה.
Example: he
islandenum<string>חובה עם country es_islands בלבד (חנויות האיים הקנריים והבלאריים), אסור בכל שוק אחר: החנות של איזה אי.
Example: tenerife
tenerife— טנריפה (האיים הקנריים).grancanaria— גראן קנריה (האיים הקנריים).lanzarote— לנסרוטה (האיים הקנריים).fuerteventura— פוארטבנטורה (האיים הקנריים).lapalma— לה פלמה (האיים הקנריים).lagomera— לה גומרה (האיים הקנריים).elhierro— אל יירו (האיים הקנריים).mallorca— מיורקה (האיים הבלאריים).menorca— מנורקה (האיים הבלאריים).ibiza— איביסה (האיים הבלאריים).
category_idstring | string[]צמצום לקטגוריה אחת או יותר מה-facets (פרמטר f-subcategories), למשל st002.
Example: st002
pageintegerdefault:1עמוד התוצאות, החל מ-1. IKEA מגישה את 2,000 התוצאות הראשונות של רשימה ועוד עמוד אחד, ולכן (page - 1) x page_size לא יעלה על 2,000.
Example: 2
page_sizeintegerdefault:24מוצרים בעמוד, 1-100.
Example: 48
sortenum<string>default:relevanceסדר התוצאות.
Example: price_asc
relevance— הסדר של האתר עצמו. ברירת המחדל.price_asc— הזול ביותר קודם.price_desc— היקר ביותר קודם.newest— החדשים ביותר קודם.rating— המדורגים ביותר קודם.name_asc— שם מ-A עד Z.most_popular— הפופולריים ביותר קודם.
colorstring | string[]מזהה צבע אחד או יותר מה-facets (פרמטר f-colors), למשל 10156 = לבן.
Example: 10156
price_bucketstringמזהה טווח מחירים מה-facets (פרמטר f-price-buckets), למשל PRICE_0_5000 = 0 עד 49.99 במטבע השוק.
Example: PRICE_0_5000
new_onlybooleanמוצרים חדשים בלבד.
Example: true
last_chancebooleanמוצרי הזדמנות אחרונה בלבד (שיוצאים מהמבחר).
Example: true
family_pricebooleanמוצרים עם מחיר חברי IKEA Family בלבד.
Example: true
top_sellerbooleanרבי מכר בלבד.
Example: true
store_idstring | integerמזהה חנות (stores[].store_id מנקודת הקצה stores). מוסיף לכל מוצר את הזמינות באותה חנות (רמת מלאי, משלוח עד הבית) ומפעיל את availability.
Example: 399
availabilityenum<string>עם store_id: in_store (במלאי בחנות, ברירת המחדל), click_collect או online.
Example: in_store
in_store— במלאי בחנות.click_collect— זמין להזמנה ואיסוף מהחנות.online— זמין באונליין.
filtersobjectכל facet אחר, לפי המפתח facets[].parameter, למשל {"f-materials": ["47350"]}. facets בוליאניים מקבלים true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX ב-IKEA ישראל, בעברית, הזול ביותר קודם. המחירים בשקלים; previous_price קיים כשיש מחיר נמוך חדש.
r = client.ikea.search(query="kallax", country="il", language="he", sort="price_asc")["data"]
print(r["total"], 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