Check the asking price for any home (GET /valuations/asking-range) — Kite API
Skip to content
KitePlatform
Pricing
Browse endpoints
All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

Analytics

Check the asking price for any home

GET/valuations/asking-range

The asking-price range for a home you describe, from the asking prices of similar homes nearby: like an appraiser's comparables, but for any unit, not just one listed on Kite. These figures are advertised asking prices of similar homes nearby, not achieved rents or sale prices, and not a valuation. Asking prices usually sit above what is finally agreed.

Answers. Always HTTP 200, with status:

  • estimate: range.low, range.mid and range.high (25th percentile, median and 75th percentile of the comparables' asking price per m², times area_sqm), confidence high or medium.
  • range_only: range.low and range.high without a mid, confidence low. Use it as a bracket, not a number.
  • insufficient_evidence: no range. cohort and comparables still show what was found.

reasons lists every code that applies:

  • location_unresolved: the neighborhood has no centre to search from (give lat/lng).
  • insufficient_comparables: fewer distinct units, or evidence clusters, than the cohort's calibrated floor.
  • dispersion_too_high: asking prices per m² vary too much to bracket the unit (coefficient of dispersion above 35%).
  • uncalibrated_cohort: no published calibration covers this city, type, bedroom count and listing type, so default search settings were used.
  • neighborhood_only_location: no point was given, so the whole neighborhood was searched.
  • listing_type_not_calibrated: rent only can return estimate for now.
  • median_interval_unavailable, median_interval_too_wide: the median is not stable enough to state.

Evidence. Comparables have the same city, listing type, property type and bedroom count, an area within the cohort's tolerance, and passed Kite's price, bedroom, area, type and location checks. They were live or seen within the look-back, and each marketed unit counts once (duplicates across portals collapse). With lat/lng the search is a calibrated radius round the point; with only neighborhood_id it is the neighborhood's own listings. furnished narrows rentals to furnished ads (true) or drops them (false). median_interval is a 95% bootstrap interval of the median asking price per m², times area_sqm, that resamples evidence clusters (projects or ~100 m cells), not single ads. range, median_interval and claimed_price_position are all on that one basis.

Not used. age_years and floor are accepted and listed in inputs_ignored, as is furnished for sales. Registered rents for the neighborhood are free at GET /market/registered-rents (see_also.registered_rents); they are not mixed into this answer.

Confidence tiers are provisional (methodology_version ends in -provisional) until they are frozen on a published forward hold-out test.

Costs 250 units a call, whatever the status.

Authentication
Send a data key (dk_live_… or dk_test_…) as a Bearer token.
Scope
market
Cost
250 units per call

Parameters

NameDescription
cityrequiredType: string · query

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.

neighborhood_idType: integer · query

Neighborhood id from GET /cities/{city}/neighborhoods. Give it, lat and lng, or both. Unknown ids are a 404.

latType: number · query

Latitude of the home (WGS 84). Give with lng.

lngType: number · query

Longitude of the home (WGS 84). Give with lat.

property_typerequiredType: string · query

The home's property type.

One of: apartment, villa, floor, duplex

listing_typerequiredType: string · query

rent (yearly rent) or sale.

One of: rent, sale

bedroomsrequiredType: integer · query

Bedrooms; comparables must match exactly.

area_sqmrequiredType: number · query

Built-up area of the home in m².

furnishedType: string · query

Rentals: true compares with furnished ads only, false leaves furnished ads out. Ignored for sales.

One of: true, false

age_yearsType: integer · query

Building age in years. Accepted, not used yet (see inputs_ignored).

floorType: integer · query

Floor the unit is on (0 = ground). Accepted, not used yet.

claimed_priceType: integer · query

A price to position against the comparables (asked, offered or applied for): SAR per year for rent, total SAR for sale.

Response

The data field is an object with these fields.

NameDescription
statusrequiredType: string

estimate, range_only or insufficient_evidence. See the endpoint description.

One of: estimate, range_only, insufficient_evidence

reasonsrequiredType: string[]

Why the answer is not a higher tier; empty for an unqualified estimate.

One of: location_unresolved, insufficient_comparables, dispersion_too_high, uncalibrated_cohort, neighborhood_only_location, listing_type_not_calibrated, median_interval_unavailable, median_interval_too_wide

basisrequiredType: string

Every figure is built from advertised asking prices.

One of: asking_prices

noticerequiredType: string

Show this wherever you show the figures.

One of: These figures are advertised asking prices of similar homes nearby, not achieved rents or sale prices, and not a valuation. Asking prices usually sit above what is finally agreed.

price_basisrequiredType: 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

rangerequiredType: object | null

Comparables' asking price per m² percentiles times area_sqm. Null for insufficient_evidence.

median_intervalrequiredType: object | null

95% cluster-bootstrap interval of the comparables' median asking price per m², times area_sqm (the basis of range). Null without a range.

confidencerequiredType: string | null

high or medium with an estimate, low with range_only, null otherwise.

claimed_price_positionrequiredType: object | null

Null without claimed_price or without a range.

locationrequiredType: object | null

Null when the location could not be resolved.

cohortrequiredType: object | null

What was searched and found. Null when the location is unresolved.

comparablesrequiredType: object[]

Up to 15 comparables, nearest first.

inputs_ignoredrequiredType: string[]

Inputs you sent that did not affect this answer.

One of: age_years, floor, furnished

methodology_versionrequiredType: string
see_alsorequiredType: object

Related free data, not part of this answer.

Example request

cURL
curl "https://api.kite.sa/v1/valuations/asking-range?city=riyadh&property_type=apartment&listing_type=rent&bedrooms=3&area_sqm=150" \  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite(); // reads KITE_API_KEYconst result = await kite.valuations.askingRange({ city: "riyadh", property_type: "apartment", listing_type: "rent", bedrooms: 3, area_sqm: 150 });
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.valuations.asking_range(city="riyadh", property_type="apartment", listing_type="rent", bedrooms=3, area_sqm=150)

Open in the interactive reference

Related endpoints

  • Get comparable listingsGET /listings/{id}/comparables
  • Get a listing's market positionGET /listings/{id}/market-position
  • Get a listing's nearby asking-price bandGET /listings/{id}/price-band
  • Find below-market listingsGET /market/below-market
  • Find below-market listings (old path)GET /market/deals
  • Get gross rental yieldGET /market/rental-yield
  • Get price trendsGET /market/trends
  • Compare neighborhoodsGET /market/neighborhoods/compare
  • List advertisers by matching listingsGET /advertisers

Guides

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

Ready to make a request? The Sandbox plan is free. For volume or licensing, talk to us.

Get an API keyTalk to us
Kite API

Saudi real estate data for developers.

Product
  • Data coverage
  • Pricing
  • Investors and developers
  • Valuation checks
  • Proptech and apps
Developers
  • Quickstart
  • Guides
  • API reference
  • MCP server
  • JavaScript SDK (npm)
  • Python SDK (PyPI)
  • Changelog
  • Status
Company
  • kite.sa
  • Blog
  • Contact
  • Security
Legal
  • Terms
  • Sources and data rights
  • Privacy
  • DPA
  • Subprocessors
© Kite