جلب بيانات التواصل مع معلن الإعلان (GET /listings/{id}/contact) — Kite API
تخطَّ إلى المحتوى
Kiteالمنصة
الباقات
تصفح نقاط النهاية
كل نقاط النهاية

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

الإعلانات

جلب بيانات التواصل مع معلن الإعلان

GET/listings/{id}/contact

رقم هاتف المعلن لإعلان نشط واحد. للتواصل مع المعلن بشأن هذا الإعلان فقط، لا لقوائم التسويق ولا لإعادة البيع.

لا يُعاد الرقم إلا إذا حمل الإعلان ترخيصًا من الهيئة العامة للعقار (ترخيص إعلان، ويحمله أيضًا الملّاك الذين يعلنون عن عقاراتهم بأنفسهم، أو ترخيص فال للوساطة)، وكان لدى كايت رقم له، ولم يشمله طلب حجب أو طلب إزالة. وإلا تكون available بالقيمة false ويوضح reason السبب؛ ويبقى source_url موصلًا للإعلان الأصلي. ويخبرك advertiser.contact_available في الإعلان بذلك مسبقًا.

يتطلب النطاق listings:contact، وهو غير مشمول في أي خطة: تفعّله كايت للمؤسسة عند الطلب. لا يمكن استدعاؤه بمفاتيح الاختبار ولا من ساحة التجربة في لوحة التحكم. لكل مؤسسة 200 رقم يوميًا عبر كل مفاتيحها، تتجدد عند منتصف الليل بتوقيت الرياض (UTC+3)، وبعدها يعيد الطلب 429 contact_daily_cap_exceeded مع Retry-After. الإجابات التي لا تحمل رقمًا لا تُحتسب. يُسجَّل كل استعلام مع مؤسستك ومفتاحك والإعلان. الاستجابات بترويسة Cache-Control: private, no-store: لا تخزّن الرقم مؤقتًا ولا تحتفظ به بعد المحادثة التي جلبته لأجلها.

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

المعاملات

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

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

الاستجابة

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

الاسمالوصف
availableمطلوبالنوع: boolean
reasonمطلوبالنوع: string | null

سبب عدم إعادة رقم؛ null عندما تكون available بالقيمة true. unlicensed: لا يحمل الإعلان ترخيصًا من الهيئة العامة للعقار (لا ترخيص إعلان ولا ترخيص فال). removal_requested: طلب المعلن أو المالك إزالة الإعلان. suppressed: يشمل هذا المعلن أو الإعلان طلب حجب. no_phone: الإعلان مرخّص لكن لا رقم لدى كايت له.

phoneمطلوبالنوع: string | null

رقم هاتف المعلن كما نُشر.

whatsappمطلوبالنوع: string | null

رقم واتساب، إذا قدّمه المصدر منفصلًا عن الهاتف.

source_urlمطلوبالنوع: string | null

رابط kite.sa يحوّل للإعلان الأصلي، حيث يمكن التواصل مع المعلن عبر المصدر. null في Sandbox أو إذا لم يملك المصدر صفحة إعلان.

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

cURL
curl "https://api.kite.sa/v1/listings/128647/contact" \  -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.listings.contact(128647);
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.listings.contact(128647)

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

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

  • البحث عن الإعلاناتGET /listings
  • عدّ الإعلاناتGET /listings/count
  • جلب الإعلانات بالمعرّفGET /listings/batch
  • جلب إعلانGET /listings/{id}
  • سجل سعر إعلانGET /listings/{id}/price-history

الأدلة

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

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

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

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

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