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.midandrange.high(25th percentile, median and 75th percentile of the comparables' asking price per m², timesarea_sqm),confidencehighormedium.range_only:range.lowandrange.highwithout a mid,confidencelow. Use it as a bracket, not a number.insufficient_evidence: no range.cohortandcomparablesstill show what was found.
reasons lists every code that applies:
location_unresolved: the neighborhood has no centre to search from (givelat/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 returnestimatefor 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
| Name | Description |
|---|---|
cityrequiredType: string · query | City slug from GET /cities. A town inside a covered region is accepted and resolved to its city ( |
neighborhood_idType: integer · query | Neighborhood id from GET /cities/{city}/neighborhoods. Give it, |
latType: number · query | Latitude of the home (WGS 84). Give with |
lngType: number · query | Longitude of the home (WGS 84). Give with |
property_typerequiredType: string · query | The home's property type. One of: |
listing_typerequiredType: string · query |
One of: |
bedroomsrequiredType: integer · query | Bedrooms; comparables must match exactly. |
area_sqmrequiredType: number · query | Built-up area of the home in m². |
furnishedType: string · query | Rentals: One of: |
age_yearsType: integer · query | Building age in years. Accepted, not used yet (see |
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.
| Name | Description |
|---|---|
statusrequiredType: string |
One of: |
reasonsrequiredType: string[] | Why the answer is not a higher tier; empty for an unqualified estimate. One of: |
basisrequiredType: string | Every figure is built from advertised asking prices. One of: |
noticerequiredType: string | Show this wherever you show the figures. One of: |
price_basisrequiredType: string | What the One of: |
rangerequiredType: object | null | Comparables' asking price per m² percentiles times |
median_intervalrequiredType: object | null | 95% cluster-bootstrap interval of the comparables' median asking price per m², times |
confidencerequiredType: string | null |
|
claimed_price_positionrequiredType: object | null | Null without |
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: |
methodology_versionrequiredType: string | |
see_alsorequiredType: object | Related free data, not part of this answer. |
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 - Find below-market listings (old path)
GET /market/deals - Get gross rental yield
GET /market/rental-yield - Get price trends
GET /market/trends - Compare neighborhoods
GET /market/neighborhoods/compare - List advertisers by matching listings
GET /advertisers