Analytics

Find below-market listings (old path)

GET/market/dealsDeprecated

Deprecated: use GET /market/below-market, which takes the same parameters and returns the same response. This path keeps working until 2027-06-30.

Residential listings asking noticeably less than similar listings nearby, biggest gap first. These are listings, not deals: "deal" in this API means a registered transaction (GET /transactions).

Each listing is compared with Kite's published nearby asking-price comparison: the same property type and bedroom count, a similar area, within a calibrated radius and look-back (disclosed per listing in comparison), one observation per distinct unit, and the subject's own duplicates excluded. A listing appears only when the comparison is published for its cohort and its direction is stable under a 95% cluster bootstrap, so thin or noisy evidence never puts a listing here. This is an asking-price comparison, not a valuation.

Listings are drawn from 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. Paginate with cursor.

Authentication

Send a data key (dk_live_… or dk_test_…) as a Bearer token.

Scope

analytics

Cost

NaN units per call

Parameters

Response

The data field is a list; each item has these fields.

Example request

curl "https://api.kite.sa/v1/market/deals?city=riyadh&listing_type=rent" \
  -H "Authorization: Bearer $KITE_API_KEY"

import { Kite } from "@kite-sa/sdk";

const kite = new Kite(); // reads KITE_API_KEY
const result = await kite.analytics.deals({ city: "riyadh", listing_type: "rent" });

from kite_sa import Kite

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

Open in the interactive reference

Related endpoints

• Get comparable listings GET /listings/{id}/comparables
• Get a listing's market position GET /listings/{id}/market-position
• Get a listing's nearby asking-price band GET /listings/{id}/price-band
• Find below-market listings GET /market/below-market
• Get gross rental yield GET /market/rental-yield
• Get price trends GET /market/trends
• Compare neighborhoods GET /market/neighborhoods/compare

Guides

• Quickstart
• What a listing is
• Coverage and freshness
• Limits and quotas
• Errors