Market summary

GET/market/summary

Headline numbers for a city (or neighborhoods): listing count, median and quartile price, median area and price per m², how recently listings were updated, and breakdowns by property type, top neighborhoods by volume, and source.

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
`city`requiredquery	`string`	City slug from GET /cities. A town inside a covered region is accepted and resolved to its city (`dammam`, `khobar`, `dhahran`, `jubail` and `qatif` to `eastern_province`; `buraydah` and `unaizah` to `qassim`; `hofuf` to `al_ahsa`), as are Arabic city names. The response's `filters.city` and the `X-Resolved-City` header show the slug used.
`listing_type`requiredquery	`string`	`rent` (prices are yearly rent) or `sale` (prices are total price). One of: `rent`, `sale`
`listing_category`query	`string`	Defaults to `residential` when `property_type` is omitted, so dwellings and commercial stock are never mixed into one median. With a `property_type`, omit it to include both categories of that type. One of: `residential`, `commercial`
`property_type`query	`string`	One property type, see GET /enums. One of: `apartment`, `villa`, `floor`, `duplex`, `office`, `shop`, `warehouse`, `land`, `building`
`beds`query	`integer`	Exact number of bedrooms (0 = studio).
`neighborhood_id`query	`integer[]`	Limit to one or more neighborhoods (comma-separated ids from GET /cities/{city}/neighborhoods). Unknown ids are a 404.

Response

The data field is an object with these fields.

Name	Type	Description
`filters`required	`object`	The filters the numbers were computed for, after defaults.
`price_basis`required	`string`	What the `*_sar` price fields mean: `yearly_rent` (SAR per year) for rentals, `sale_price` (total SAR) for sales. One of: `yearly_rent`, `sale_price`
`price_source`required	`string`	Where the prices come from: `asking` = advertised asking prices from listings; `registered` = registered transactions or rent contracts. Asking prices typically sit above what is finally agreed. One of: `asking`, `registered`
`sample_size`required	`integer`	Listings in the sample.
`median_price_sar`required	`integer \| null`	Median price.
`p25_price_sar`required	`integer \| null`	25th percentile price.
`p75_price_sar`required

Example request

curl

curl "https://api.kite.sa/v1/market/summary?city=riyadh&listing_type=rent" \
  -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.market.summary({ city: "riyadh", listing_type: "rent" });

Python (kite-sa)

from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.market.summary(city="riyadh", listing_type="rent")

Open in the interactive reference

Related endpoints

Price distribution GET /market/price-distribution
Area distribution GET /market/area-distribution
New supply GET /market/supply
Vacancy indicator GET /market/vacancy
Prices by neighborhood GET /market/neighborhoods
Commercial rent per m² by neighborhood GET /market/commercial-rents

Guides

Market data