IKEA
واجهة فئات منتجات IKEA API
منتجات فئة واحدة من IKEA عبر معرّف الفئة أو رابطها، مع أنماط الفرز والفلاتر نفسها التي يقبلها البحث: لكل منتج رقمه واسمه ونوعه وتصميمه وسعره وسعره السابق بعملة السوق، ووسم السعر والتقييم والمتغيرات ومسار الفئة، إضافة إلى الفئة (id وname وurl وparents) وtotal والـ facets. في أسواق 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/jsoncategory_idstringمعرّف فئة: categories[].id من نقطة categories، أو معرّف من category_path أو facets في بحث، مثلًا 11465 = وحدات أرفف في ae. أرسل category_id أو url.
Example: 11465
urlstringصفحة فئة على IKEA، بديلًا عن category_id.
Example: https://www.ikea.com/ae/ar/cat/kallax-shelving-units-58285/
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")
# وحدات الأرفف في الإمارات، الأرخص أولًا، 48 في الصفحة.
r = client.ikea.category(category_id="11465", country="ae", language="ar", sort="price_asc", page_size=48)["data"]
print(r["category"]["name"], r["total"], r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"])Response