Get comparable listings (GET /listings/{id}/comparables) — Kite API
KitePlatform
Use casesDocsGuidesPricing
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

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by 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

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
  • Search project units
  • List developers

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
  • 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

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood

Analytics

Get comparable listings

GET/listings/{id}/comparables

Active listings similar to this one, nearest first, with how each one differs.

A comparable has the same city, listing type and property type, is within about 5 km, and has an area between 2/3 and 1.5 times this listing's (the comparison-approach caliper). Residential comparables also have the same bedroom count and must pass Kite's price, bedroom, area, property-type and location quality checks. Both this listing's and each comparable's area must be trustworthy, so listings without coordinates or with an unreliable area return no comparables and say why in unavailable_reason.

summary describes the comparables returned (it depends on limit). 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.

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

Parameters

NameTypeDescription
idrequiredpathinteger

Listing id.

limitqueryinteger

How many comparables to return.

Response

Kite API

Saudi real estate data for developers.

Product
  • API reference
  • Data coverage
  • Pricing
  • Valuation checks
  • Changelog
  • Status
Company
  • kite.sa
  • Contact
  • Security
Legal
  • Terms
  • Subprocessors
© Kite
  • Commercial rent per m² by 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

    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
    • Search project units
    • List developers

    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
    • Delete a webhook endpoint
    • List deliveries
    • Replay a delivery

    Interactive reference

    The data field is an object with these fields.

    NameTypeDescription
    listing_idrequiredinteger
    price_basisrequiredstring

    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_sourcerequiredstring

    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

    unavailable_reasonrequiredstring | null

    Why no comparables could be searched for: the listing has no coordinates, or its area is missing or failed Kite's area checks. Null when the search ran.

    criteriarequiredobject
    summaryrequiredobject
    comparablesrequiredobject[]

    Example request

    curl
    curl "https://api.kite.sa/v1/listings/128647/comparables" \
  -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.analytics.listingComparables(128647);
    Python (kite-sa)
    from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.analytics.listing_comparables(128647)

    Open in the interactive reference

    Related endpoints

    • 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

    Guides

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