المعلنون بحسب الإعلانات المطابقة (GET /advertisers) — Kite API
تخطَّ إلى المحتوى
Kiteالمنصة
الباقات
تصفح نقاط النهاية
كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان
  • جلب بيانات التواصل مع معلن الإعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء
  • المعلنون بحسب الإعلانات المطابقة
  • تحقق من السعر المطلوب لأي منزل

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • تحديث نقطة Webhook
  • إعادة تفعيل نقطة Webhook
  • تدوير سر توقيع Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان
  • جلب بيانات التواصل مع معلن الإعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء
  • المعلنون بحسب الإعلانات المطابقة
  • تحقق من السعر المطلوب لأي منزل

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • تحديث نقطة Webhook
  • إعادة تفعيل نقطة Webhook
  • تدوير سر توقيع Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

التحليلات

المعلنون بحسب الإعلانات المطابقة

GET/advertisers

المعلنون أصحاب الإعلانات التي يطابقها البحث: صف لكل معلن، فيه عدد إعلاناته المطابقة ونطاق أسعاره وأين يعلن. يقبل كل فلاتر GET /listings، فسؤال مثل «الوسطاء الذين لديهم شقق فوق 40,000 ريال سنويًا في شمال الرياض» طلب واحد بدل تصفّح الإعلانات وتجميعها بنفسك.

أي الإعلانات تُحتسب. الإعلانات النشطة نفسها، بعد إزالة التكرار وفلترة الجودة، التي يعيدها GET /listings لهذه الفلاتر، ومنها فقط ما يذكر GET /listings اسم معلنه: إعلان يحمل ترخيصًا من الهيئة العامة للعقار (ترخيص إعلان أو رخصة فال للوساطة) ولا يشمله طلب إزالة أو حجب. تُستبعد إعلانات المعلنين غير المرخصين أو غير المسمَّين، لذلك يكون totals.listings غالبًا أقل من GET /listings/count للفلاتر نفسها.

من هو المعلن الواحد. تُجمع الإعلانات بحسب اسم المكتب الظاهر في الإعلان (الشركة، أو اسم الشخص إن لم يذكر الإعلان شركة) دون تمييز بين الأحرف الكبيرة والصغيرة. لا يدمج كايت اختلافات الكتابة، فالمكتب الذي ينشر باسم عربي في مصدر وباسم إنجليزي في مصدر آخر يظهر مرتين. fal_number هو رخصة فال الأكثر ورودًا في إعلاناته المطابقة؛ والمكتب الذي يحمل كل وسيط فيه رخصته الخاصة له عدة رخص، وعددها في fal_licences.

فوق الوسيط. مرّر above_median_pct لاحتساب الإعلانات التي يزيد سعرها بأكثر من هذه النسبة على وسيط السعر المطلوب للإعلانات المماثلة فقط: المدينة ونوع الإعلان والحي ونوع العقار وعدد غرف النوم نفسها، حيث يوجد 5 إعلانات مماثلة على الأقل. القيمة 0 تعني أي زيادة. الإعلان الذي لا مجموعة مماثلة له (بلا حي، أو قلّ ما يماثله) لا يطابق أبدًا. يُحسب الوسيط على كل إعلانات المدينة ونوع الإعلان بعد فلترة الجودة، لا على ما يطابق فلاترك الأخرى فقط.

بلا أرقام هواتف. بيانات الاتصال ليست جزءًا من هذه الاستجابة. sample_listing_ids هي أعلى إعلانات المعلن المطابقة سعرًا؛ مرّر أحدها إلى GET /listings/{id}/contact (ويتطلب الصلاحية listings:contact) أو إلى GET /listings/batch.

الأسعار أسعار مطلوبة لإعلانات نشطة، بالريال؛ والإيجارات سنوية.

المصادقة
أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
النطاق
analytics
التكلفة
50 وحدة لكل طلب

المعاملات

الاسمالوصف
cityمطلوبالنوع: string · الاستعلام

اسم المدينة المختصر من GET /cities. تُقبل بلدة داخل منطقة مغطاة وتُحوَّل إلى مدينتها (dammam وkhobar وdhahran وjubail وqatif إلى eastern_province؛ وburaydah وunaizah إلى qassim؛ وhofuf إلى al_ahsa)، وكذلك أسماء المدن بالعربية. يبين filters.city في الاستجابة وترويسة X-Resolved-City الاسم المختصر المستخدم.

listing_typeمطلوبالنوع: string · الاستعلام

إحدى القيم: rent, sale

listing_categoryالنوع: string · الاستعلام

احذفه لتضمين النوعين.

إحدى القيم: residential, commercial

property_typeالنوع: string[] · الاستعلام

قيمة أو أكثر، مفصولة بفواصل.

إحدى القيم: apartment, villa, floor, duplex, office, shop, warehouse, land, building

neighborhood_idالنوع: integer[] · الاستعلام

معرّفات الأحياء من GET /cities/{city}/neighborhoods.

bedsالنوع: integer · الاستعلام

عدد غرف النوم المطابق تمامًا لكل قيمة بما فيها 5. يعامل مرشّح kite.sa الرقم 5 كخمس غرف أو أكثر، فتختلف مجموعات النتائج هنا. استخدم beds_min للنطاق.

beds_minالنوع: integer · الاستعلام

أقل عدد لغرف النوم.

beds_maxالنوع: integer · الاستعلام

أكبر عدد لغرف النوم.

bathrooms_minالنوع: integer · الاستعلام

أقل عدد لدورات المياه.

price_minالنوع: integer · الاستعلام

بالريال السعودي. سنوي للإيجار؛ راجع price.yearly_sar.

price_maxالنوع: integer · الاستعلام

بالريال السعودي. سنوي للإيجار؛ راجع price.yearly_sar.

area_minالنوع: number · الاستعلام

أمتار مربعة.

area_maxالنوع: number · الاستعلام

أمتار مربعة.

furnishedالنوع: string · الاستعلام

true يطابق الإعلانات المؤكد أنها مفروشة. false يطابق كل إعلان لم يتأكد أنه مفروش: ما ذُكر أنه غير مفروش وما لم يذكر ذلك. احذفه لتضمين الكل.

إحدى القيم: true, false

sourceالنوع: string[] · الاستعلام

منصات المصادر، راجع GET /enums. لا تُفحص القيم مقابل القائمة، لذا يعيد المصدر المكتوب خطأ نتائج فارغة بدل خطأ.

bboxالنوع: string · الاستعلام

مستطيل الإحاطة west,south,east,north بالدرجات وبترتيب GeoJSON.

updated_sinceالنوع: string (date-time) · الاستعلام

إعلانات updated_at فيها عند وقت ISO 8601 هذا أو بعده فقط. ادمجه مع sort=updated_asc للمزامنة.

bathroomsالنوع: integer · الاستعلام

عدد دورات المياه المطابق تمامًا.

bathrooms_maxالنوع: integer · الاستعلام

أكبر عدد لدورات المياه.

livings_minالنوع: integer · الاستعلام

أقل عدد لغرف المعيشة.

neighborhood_id_excludeالنوع: integer[] · الاستعلام

استبعد هذه الأحياء بمعرّفات GET /cities/{city}/neighborhoods. تبقى الإعلانات التي تعذر تعيين حيّها، بخلاف neighborhood_id الذي يستبعدها.

qالنوع: string · الاستعلام

مطابقة نص حر في عنوان المعلن ووصفه كما نشرهما، لا headline الذي يصوغه كايت للاستجابة. يجب ظهور كل الكلمات؛ استخدم "quote a phrase" لمطابقة عبارة كاملة و| بين الكلمات لقبول أي منها. المصادر بلا عنوان، ومنها عقار، تُطابق الوصف فقط.

amenitiesالنوع: string[] · الاستعلام

إعلانات تحتوي كل هذه المرافق فقط. راجع GET /enums.

إحدى القيم: ac, kitchen, maid_room, parking, private_roof, lift, pool, gym, balcony, garden, laundry_room

amenities_excludeالنوع: string[] · الاستعلام

استبعد الإعلانات التي تحتوي أيًا منها.

إحدى القيم: ac, kitchen, maid_room, parking, private_roof, lift, pool, gym, balcony, garden, laundry_room

photo_featuresالنوع: string[] · الاستعلام

فقط الإعلانات التي تُظهر صورها كل ما يلي: real_photos (صور العقار نفسه لا التصاميم ولا الصور الجاهزة)، kitchen_installed (مطبخ راكب)، ac_split، pool، roof_terrace، balcony، large_windows (صالة أو غرفة نوم بنوافذ كبيرة). تُقرأ هذه من صور الإعلان بنموذج رؤية آلي، ولا تُنشر إلا للمميزات التي يتعرّف عليها بدقة عالية. لذلك هذا مرشّح «يجب أن تتوفر» فقط: الإعلان الذي لا تُظهر صوره الميزة، أو الذي لم يُحلَّل بعد، لا يطابق، ولا توجد طريقة لطلب إعلانات بلا ميزة معيّنة. التغطية تشمل المنازل التي لها صور، وقد لا تكون الإعلانات المضافة حديثًا قد حُلّلت بعد.

إحدى القيم: real_photos, kitchen_installed, ac_split, pool, roof_terrace, balcony, large_windows

floorالنوع: string · الاستعلام

ground للأرضي وupper لأي طابق معلن فوقه. لا يقسمان كل النتائج: الإعلان بلا طابق محدد لا يدخل أيًا منهما.

إحدى القيم: ground, upper

source_excludeالنوع: string[] · الاستعلام

استبعد منصات المصادر هذه؛ راجع GET /enums.

max_ageالنوع: integer · الاستعلام

أقصى عمر للعقار بالسنوات. في الرياض يُطابَق العمر مع رخص البناء البلدية الصادرة منذ 2018: إذا ذكر الإعلان أن المبنى أحدث بأربع سنوات أو أكثر مما تسمح به أحدث رخصة، يُستخدم عمر الرخصة (سنة الرخصة مضافًا إليها سنة للبناء). ولا تجعل الرخصة المبنى أحدث مما يذكره إعلانه. ويسجّل عقار عمرًا يساوي 0 حين يترك المعلن الحقل فارغًا، لذا لا يُعدّ إعلان عقار بعمر 0 جديدًا إلا إذا دعمته رخصة في الرياض أو نص الإعلان نفسه (أول ساكن، لم يُسكن، حديث البناء)؛ وإلا فعمره غير معروف ولا يطابق الفلتر. وإذا ذكر وصف الإعلان نفسه عمر المبنى («العمر 8 سنوات») وكان أكبر بثلاث سنوات أو أكثر من حقل العمر، أو كان الحقل فارغًا، يُستخدم العمر الوارد في الوصف.

verifiedالنوع: string · الاستعلام

true لما يعلّمه المصدر كمتحقق. تعني false البقية: غير المتحقق وما لم يذكر المصدر حالة تحققه.

إحدى القيم: true, false

advertiser_typeالنوع: string · الاستعلام

الجهة التي نشرت الإعلان، حيث يذكرها المصدر. company تجمع المكاتب وشركات الوساطة والمطورين؛ وindividual تجمع الوسطاء الأفراد والملاك. كثير من الإعلانات لا يطابق أيًا منهما: مصدرها لا يذكر أي فئة (عقار، وهو أكبر المصادر، لا يذكرها)، أو يذكر وسيطًا دون بيان هل هو شركة أم فرد. فمجموع القيمتين أقل بكثير من كل الإعلانات؛ لا تستخدم هذا الفلتر لتقدير حجم السوق.

إحدى القيم: company, individual

compoundالنوع: string · الاستعلام

اسم المجمع، بمطابقة جزئية.

in_compoundالنوع: string · الاستعلام

الإعلانات التابعة لأي مجمع فقط.

إحدى القيم: true, false

rent_frequencyالنوع: string · الاستعلام

فترة الإيجار في الإعلان. يبقى price.yearly_sar سنويًا؛ راجع price.as_posted.

إحدى القيم: monthly, yearly

days_on_market_minالنوع: integer · الاستعلام

الأيام منذ رصد كايت للإعلان أول مرة.

days_on_market_maxالنوع: integer · الاستعلام

الأيام منذ رصد كايت للإعلان أول مرة.

zoningالنوع: string[] · الاستعلام

الإعلانات التي تقع قطعتها ضمن أيٍّ من هذه التصنيفات (plot.zoning) فقط، مفصولة بفواصل. مثل كل فلاتر القطعة، لا يطابق إلا الإعلانات التي لها plot.

إحدى القيم: residential, commercial, mixed, industrial, agricultural, public, other

cornerالنوع: string · الاستعلام

true: القطع الواقعة على زاوية فقط (plot.is_corner)؛ false: القطع التي ليست على زاوية.

إحدى القيم: true, false

street_width_minالنوع: number · الاستعلام

أدنى عرض بالأمتار لأعرض شارع تطل عليه القطعة (plot.street_width_m).

white_land_feeالنوع: string · الاستعلام

true: القطع الواقعة ضمن شريحة لرسوم الأراضي البيضاء (plot.white_land_fee)؛ false: القطع الواقعة خارج كل الشرائح. الشرائح مرسومة للرياض فقط، لذا لا تطابق false شيئًا في المدن الأخرى.

إحدى القيم: true, false

last_sale_within_monthsالنوع: integer · الاستعلام

الإعلانات التي لا يزيد عمر آخر صفقة مسجلة على قطعتها (plot.last_registered_sale) على هذا العدد من الأشهر التقويمية (months_since) فقط. للأراضي والفلل والمباني فقط: الشقق والأدوار والدوبلكسات ليس لها آخر صفقة.

ask_to_last_sale_maxالنوع: number · الاستعلام

إعلانات البيع فقط: لا يزيد السعر المطلوب على هذا المضاعف من آخر صفقة مسجلة على القطعة، بين الإعلانات التي تتفق مساحتها مع مساحة الصك (plot.last_registered_sale.ask_to_last_sale_ratio). القيمة 1.05 تجد القطع المعروضة بما لا يزيد 5% على سعر بيعها الأخير.

plot_soldالنوع: string · الاستعلام

true: الإعلانات التي سُجّلت صفقة بيع على قطعتها أثناء عرض الإعلان فقط (plot.registered_sale_while_listed)، وهي في السوق قطع بيعت على الأرجح. false: يستبعدها ويُبقي كل إعلان لا صفقة كهذه له، ومنها الإعلانات التي ليس لها plot. لإعلانات بيع الأراضي والفلل والمباني.

إحدى القيم: true, false

above_median_pctالنوع: number · الاستعلام

احتساب الإعلانات التي يزيد سعرها بأكثر من هذه النسبة على وسيط الإعلانات المماثلة فقط (الحي ونوع العقار وغرف النوم نفسها، 5 إعلانات على الأقل). 0 = أي زيادة.

min_listingsالنوع: integer · الاستعلام

المعلنون الذين لديهم هذا العدد من الإعلانات المطابقة على الأقل فقط.

sortالنوع: string · الاستعلام

listings_desc (الأكثر إعلانات مطابقة أولًا) أو median_price_desc (الأعلى وسيطًا للسعر المطلوب أولًا).

إحدى القيم: listings_desc, median_price_desc

limitالنوع: integer · الاستعلام
cursorالنوع: string · الاستعلام

الاستجابة

الحقل data كائن بهذه الحقول.

الاسمالوصف
price_basisمطلوبالنوع: string

معنى حقول السعر *_sar: yearly_rent بالريال سنويًا للإيجار، وsale_price إجمالي الريال للبيع.

إحدى القيم: yearly_rent, sale_price

price_sourceمطلوبالنوع: string

مصدر السعر: asking للأسعار المطلوبة في الإعلانات، وregistered للصفقات أو عقود الإيجار المسجلة. عادة تتجاوز أسعار العرض السعر النهائي المتفق عليه.

إحدى القيم: asking, registered

totalsمطلوبالنوع: object

على مستوى كل الصفحات: المعلنون الذين لديهم min_listings إعلانًا مطابقًا على الأقل، والإعلانات التي لديهم.

advertisersمطلوبالنوع: object[]

مثال على الطلب

cURL
curl "https://api.kite.sa/v1/advertisers?city=riyadh&listing_type=rent" \  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite(); // reads KITE_API_KEYconst result = await kite.analytics.advertisers({ city: "riyadh", listing_type: "rent" });
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.analytics.advertisers(city="riyadh", listing_type="rent")

افتح في المرجع التفاعلي

نقاط نهاية ذات صلة

  • جلب الإعلانات المقارنةGET /listings/{id}/comparables
  • موقع سعر الإعلان في السوقGET /listings/{id}/market-position
  • نطاق أسعار العرض القريبة لإعلانGET /listings/{id}/price-band
  • إعلانات أقل من أسعار السوقGET /market/below-market
  • إعلانات أقل من أسعار السوق (المسار القديم)GET /market/deals
  • العائد الإيجاري الإجماليGET /market/rental-yield
  • اتجاهات الأسعارGET /market/trends
  • مقارنة الأحياءGET /market/neighborhoods/compare
  • تحقق من السعر المطلوب لأي منزلGET /valuations/asking-range

الأدلة

  • البدء السريع
  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات
  • الحدود والحصص
  • الأخطاء

جاهز لإرسال أول طلب؟ خطة Sandbox مجانية. للأحجام الكبيرة أو الترخيص، تواصل معنا.

احصل على مفتاح APIتواصل معنا
Kite API

بيانات العقارات السعودية للمطوّرين.

المنتج
  • تغطية البيانات
  • الباقات
  • المستثمرون والمطورون
  • فحوصات التقييم
  • التقنية العقارية والتطبيقات
المطورون
  • البدء السريع
  • الأدلة
  • مرجع API
  • خادم MCP
  • مكتبة JavaScript (npm)
  • مكتبة Python (PyPI)
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • المدونة
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • المصادر وحقوق البيانات
  • الخصوصية
  • ملحق معالجة البيانات
  • جهات المعالجة الفرعية
© Kite