Get a listing's market position
GET/listings/{id}/market-position
Where a listing's price sits in its market: percentile, quartiles and difference from the median, against like-for-like listings in its neighborhood and in its city.
The cohort is listings with the same listing type, category and property type, and for residential listings the same bedroom count. basis says which cohort the top-level price_percentile and diff_from_median_pct use: the neighborhood when it has at least 30 listings, otherwise the city.
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 rentals (monthly, weekly and daily postings are converted to a yearly amount), total price for sales. Medians and quartiles are null when fewer than 5 listings back them; check sample_size before relying on a number. listing_in_sample says whether the listing itself passed those filters (a listing not updated in 30 days, or priced as an outlier, is compared but not counted).
- Authentication
- Send a data key (dk_live_… or dk_test_…) as a Bearer token.
- Scope
analytics- Cost
- 50 units per call
Parameters
| Name | Type | Description |
|---|---|---|
idrequiredpath |