جلب الإعلانات المقارنة (GET /listings/{id}/comparables) — Kite API
Kiteالمنصة
الاستخداماتالتوثيقالأدلةالباقات
تصفح نقاط النهاية
كل نقاط النهاية

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي

التحليلات

جلب الإعلانات المقارنة

GET/listings/{id}/comparables

إعلانات نشطة مشابهة، الأقرب أولًا، مع اختلاف كل منها.

للإعلان المقارن المدينة ونوع العرض ونوع العقار نفسها، ضمن نحو 5 كم ومساحة بين 2/3 و1.5 من مساحة الإعلان، وفق هامش نهج المقارنة. تتطابق غرف نوم السكني أيضًا، ويجتاز فحوص السعر والغرف والمساحة والنوع والموقع. يجب أن تكون مساحة الإعلان وكل مقارنة موثوقة؛ ما بلا إحداثيات أو مساحة موثوقة لا يعيد مقارنات ويشرح السبب في unavailable_reason.

يصف summary المقارنات المعادة ويعتمد على limit. الأسعار مطلوبة بالريال: إيجار سنوي بعد تحويل الشهري والأسبوعي واليومي، وسعر بيع إجمالي.

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

المعاملات

الاسمالنوعالوصف
idمطلوبالمسارinteger

معرّف الإعلان.

limitالاستعلامinteger

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

الاستجابة

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

الاسمالنوعالوصف
Kite API

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

المنتج
  • مرجع API
  • تغطية البيانات
  • الباقات
  • فحوصات التقييم
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • جهات المعالجة الفرعية
© Kite
الإيجار التجاري للمتر المربع بحسب الحي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

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

الإدارة

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

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

listing_id
مطلوب
integer
price_basisمطلوبstring

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

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

price_sourceمطلوبstring

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

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

unavailable_reasonمطلوبstring | null

سبب تعذر البحث عن مقارنات: بلا إحداثيات، أو المساحة مفقودة أو لم تجتز الفحوص. null إذا نُفّذ البحث.

criteriaمطلوبobject
summaryمطلوبobject
comparablesمطلوبobject[]

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

curl
curl "https://api.kite.sa/v1/listings/128647/comparables" \
  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";

const kite = new Kite(); // reads KITE_API_KEY
const result = await kite.analytics.listingComparables(128647);
Python (kite-sa)
from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.analytics.listing_comparables(128647)

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

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

  • موقع سعر الإعلان في السوق 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

الأدلة

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