IKEA
واجهة عروض IKEA API
إحدى قوائم عروض IKEA في السوق: الأسعار الأقل الجديدة، وأسعار أعضاء IKEA Family، والفرصة الأخيرة (منتجات يجري إيقافها)، والمنتجات الجديدة، وفئة الأسعار الأدنى، والأكثر مبيعًا، والإصدارات المحدودة، والعروض المحددة بوقت، وأسعار المتجر فقط، والعروض المخفّضة. يحمل كل منتج سعره وسعره السابق بعملة السوق ووسم السعر وتاريخَي صلاحيته، مع أنماط الفرز والفلاتر نفسها التي يقبلها البحث. في أسواق ikea.com الخمسين والصين (ikea.cn). التكلفة رصيد واحد لكل طلب.
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/jsontypeenum<string>requiredأي قائمة عروض.
Example: new_lower_price
new_products— المنتجات الجديدة.family_price— أسعار أعضاء IKEA Family: price هو سعر الأعضاء وprevious_price السعر العادي.new_lower_price— سعر أقل جديد: previous_price هو السعر قبل التخفيض، مع تاريخَي صلاحية السعر الجديد.last_chance— الفرصة الأخيرة: منتجات يجري إيقافها.lowest_price— فئة الأسعار الأدنى.top_seller— الأكثر مبيعًا.limited_edition— الإصدارات المحدودة.time_restricted— عروض محددة بوقت.in_store_price_only— أسعار تسري في المتجر فقط.reduced_price_offer— عروض بأسعار مخفّضة.
countrystringdefault:usسوق IKEA برمز صغير الأحرف. تخدم نقطة الاتصال هذه 51 سوقًا: أسواق ikea.com الخمسون والصين (ikea.cn). تعود الأسماء والأوصاف والتسميات بلغة السوق والأسعار بعملته، دون أي تحويل؛ وتعيد الاستجابة country وlanguage وcurrency. السوق خارج هذه القائمة يُرجع 400 قبل احتساب أي رصيد. أسواق الخليج والعالم العربي: ae وsa وkw وqa وbh وom وjo وeg وma.
Example: ae
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.
languagestringلغة الاستجابة، من اللغات التي يقدمها موقع السوق؛ الافتراضية هي الأولى (ar على ae وsa وkw وqa وbh وom وjo وeg وma، وen على us). أسواق الخليج ومصر والأردن تقبل ar أو en، والمغرب ar أو fr أو en. أسواق أخرى متعددة اللغات: us en/es، ca en/fr، de وat de/en، ch de/fr/it/en، be nl/fr/en، es es/en/ca/eu/gl، my ms/en، th th/en، jp ja/en، kr ko/en، cn zh/en، is en/is. أي رمز آخر يُرجع 400. السعر والعملة لا يتغيران مع اللغة.
Example: ar
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")
# الأسعار الأقل الجديدة في الإمارات، الأغلى أولًا، 100 في الصفحة.
r = client.ikea.deals(type="new_lower_price", country="ae", language="ar", page_size=100, sort="price_desc")["data"]
print(r["total"], r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_from"])Response