Vacancy indicator
GET/market/vacancy
How long listings in the sample have been on the market, as a proxy for vacancy (actual occupancy isn't observed). Days on market count from when Kite first saw the listing: listings that were already up before then, or before Kite covered their source, are undercounted, and an ad re-posted under a new id starts again at zero. Compare these numbers between neighborhoods, property types or over time rather than reading them as absolute vacancy.
Computed over the market sample: active, deduplicated listings updated in the last 30 days (updated_at), after the same outlier filter kite.sa uses (per-tier price fences from the median and MAD of log price, bedroom and area sanity checks, and a floor at 30% of the neighborhood median). Prices are asking prices in SAR: yearly rent for listing_type=rent (monthly, weekly and daily postings are converted to a yearly amount), total price for listing_type=sale. Check sample_size before relying on a number; small samples are noisy.
- Authentication
- Send a data key (dk_live_… or dk_test_…) as a Bearer token.
- Scope
market- Cost
- 50 units per call
Parameters
| Name | Type | Description |
|---|---|---|
cityrequiredquery | string | City slug from GET /cities. A town inside a covered region is accepted and resolved to its city ( |