GET/listings/{id}
إعلان نشط واحد. يعيد 404 بعد البيع أو التأجير أو الإزالة أو الدمج كنسخة مكررة.
listings| الاسم | النوع | الوصف |
|---|---|---|
idمطلوبالمسار | integer | معرّف الإعلان. |
الحقل data كائن بهذه الحقول.
| الاسم | النوع | الوصف |
|---|---|---|
idمطلوب | integer | |
urlمطلوب | string | صفحة الإعلان في kite.sa. |
titleمطلوب | string | null | عنوان المعلن كما نُشر. null للمصادر بلا عناوين، كعقار؛ استخدم |
البيانات الرسمية
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 | آخر تحديث في المصدر أو آخر رصد لدى كايت إذا لم ينشر المصدر أوقات التحديث. يُستخدم في |
last_seen_atمطلوب | string (date-time) | null | آخر تأكيد في كايت أن الإعلان نشط. |
days_on_marketمطلوب | integer | null |
curl "https://api.kite.sa/v1/listings/128647" \
-H "Authorization: Bearer $KITE_API_KEY"import { Kite } from "@kite-sa/sdk";
const kite = new Kite(); // reads KITE_API_KEY
const result = await kite.listings.get(128647);from kite_sa import Kite
kite = Kite() # reads KITE_API_KEY
result = kite.listings.get(128647)GET /listingsGET /listings/countGET /listings/batchGET /listings/{id}/price-history