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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

الإعلانات

جلب الإعلانات بالمعرّف

GET/listings/batch

حتى 100 إعلان في طلب واحد وبالترتيب المطلوب. تعود المعرّفات غير النشطة بسبب البيع أو التأجير أو الإزالة أو الدمج في missing_ids.

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

المعاملات

الاسمالنوعالوصف
idsمطلوبالاستعلامinteger[]

معرّفات إعلانات مفصولة بفواصل.

الاستجابة

الحقل data قائمة، ولكل عنصر فيها هذه الحقول.

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

صفحة الإعلان في kite.sa.

titleمطلوبstring | null
Kite API

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

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

عنوان المعلن كما نُشر. null للمصادر بلا عناوين، كعقار؛ استخدم headline للعرض.

headlineمطلوبstring

وصف إنجليزي قصير مبني من حقول الإعلان. موجود دائمًا.

descriptionمطلوبstring | null

كما نُشر، عادة بالعربية.

description_enمطلوبstring | null

الترجمة الإنجليزية حيث تتوفر.

listing_typeمطلوبstring
listing_categoryمطلوبstring | null
property_typeمطلوبstring
priceمطلوبobject
financingمطلوبobject
bedroomsمطلوبinteger | null
bathroomsمطلوبinteger | null
livingsمطلوبinteger | null

غرف المعيشة.

area_sqmمطلوبnumber | null
floorمطلوبstring | null
age_yearsمطلوبinteger | null
furnishedمطلوبboolean | null
amenitiesمطلوبstring[]
locationمطلوبobject
compound_nameمطلوبstring | null
project_idمطلوبinteger | null

مشروع على الخارطة تنتمي إليه الوحدة إن رُبطت.

imagesمطلوبstring[]

روابط الصور في CDN كايت.

image_countمطلوبinteger
advertiserمطلوبobject
verified_by_sourceمطلوبboolean | null

يعلّم المصدر الإعلان كمتحقق.

sourceمطلوبobject
also_listed_onمطلوبstring[]

مصادر أخرى للعقار نفسه. يعرض كايت إعلانًا واحدًا لكل عقار.

first_seen_atمطلوبstring (date-time) | null

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

updated_atمطلوبstring (date-time) | null

آخر تحديث في المصدر أو آخر رصد لدى كايت إذا لم ينشر المصدر أوقات التحديث. يُستخدم في updated_since وترتيب updated_*.

last_seen_atمطلوبstring (date-time) | null

آخر تأكيد في كايت أن الإعلان نشط.

days_on_marketمطلوبinteger | null

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

curl
curl "https://api.kite.sa/v1/listings/batch?ids=128647%2C128650" \
  -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.listings.batch({ ids: [128647,128650] });
Python (kite-sa)
from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.listings.batch(ids=[128647,128650])

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

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

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

الأدلة

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