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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

التصدير

جلب تصدير

GET/exports/{export_id}

حالة التصدير وعند completed رابط موقّع لكل ملف صالح 60 دقيقة. اطلب مجددًا لروابط جديدة. استعلم كل بضع ثوانٍ إلى دقيقة؛ يبدأ خلال نحو دقيقة وتستغرق اللقطة الكاملة بضع دقائق.

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

المعاملات

الاسمالنوعالوصف
export_idمطلوبالمسارstring

الاستجابة

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

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

إحدى القيم: listings, listing_changes, registered_transactions, registered_rents

Kite API

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

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

formatمطلوبstring

إحدى القيم: ndjson, csv

compressionمطلوبstring

إحدى القيم: gzip, none

statusمطلوبstring

queued ثم running ثم completed، أو failed. تصبح expired بعد حذف الملفات.

إحدى القيم: queued, running, completed, failed, expired

filtersمطلوبobject | null

كما طُلب. null بعد الاكتمال إذا عطّلت المؤسسة تخزين التفاصيل.

price_sourceمطلوبstring

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

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

rows_estimatedمطلوبinteger | null

الصفوف المعدودة قبل تصدير الإعلانات، أساس تكلفة units.

row_countمطلوبinteger | null

الصفوف المكتوبة بعد الاكتمال.

unitsمطلوبinteger

الوحدات المحتسبة. 0 للمفتوحة، وتُرد عند الفشل.

progressمطلوبobject
errorمطلوبobject | null
attributionمطلوبobject | null

للصادرات المفتوحة: إشعار الترخيص الموجود أيضًا في ATTRIBUTION.txt. أبقه مع البيانات.

filesمطلوبobject[]

روابط التنزيل في GET /exports/{export_id} للتصدير المكتمل فقط.

created_atمطلوبstring (date-time)
started_atمطلوبstring (date-time) | null
completed_atمطلوبstring (date-time) | null
expires_atمطلوبstring (date-time) | null

وقت حذف الملفات.

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

curl
curl "https://api.kite.sa/v1/exports/export_id" \
  -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.exports.get("export_id");
Python (kite-sa)
from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.exports.get("export_id")

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

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

  • إنشاء تصدير POST /exports
  • قائمة الصادرات GET /exports

الأدلة

  • البدء السريع
  • مزامنة نسخة محلية
  • التصدير الشامل
  • الحدود والحصص
  • الأخطاء