Project absorption by area, developer or type (GET /market/absorption) — 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

Off-plan projects

Project absorption by area, developer or type

GET/market/absorption

Month-by-month absorption pooled over projects: per city (the default), neighborhood, developer, property type or project type, the units on offer at the start and end of each month, units gone, released and re-added, the pooled and median absorption rate, and months of stock at the month's pace. The per-project series and its rules are GET /projects/{id}/absorption; only months that are usable there are pooled, and each figure is null when fewer than min_sample_size projects have one. projects_observed, projects_usable and flagged give the sample behind every month.

This is not a sales record. A portal's or developer site's "available" count is what the page showed on the day. A unit counts as gone when the source stops offering it, which a sale, a reservation, a lease, or the developer pulling it off the page all look like from outside; reservations fall through, and developers hold units back. Read the figures as how fast the advertised offer shrinks, alongside registered deals where you need actual sales.

Which projects. Only sources that publish an inventory count can be measured: unit tables with a status per unit (Asas Makeen, Rasan; basis unit_status), a stated available count (Mada; reported_available), or the number of units listed on the project's page (Wasalt, CompoundIn; listed_units). Every other source's unit count is the project's size, which doesn't move with sales, so most projects have reliability no_inventory_signal. No source reports available units by unit type, so there is no per-type split; listing_type separates sale and rent where the source does. Copies of one project from several sources are read once, from the source with the best basis. Snapshots began on 2026-09-26. Coverage is thin and uneven: most measurable projects are in Riyadh, and a city or developer may have none; check projects_tracked and projects_usable before reading a rate.

Projects are counted by their latest location and developer, including projects that have since gone inactive (for the months they were on offer).

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

Parameters

NameDescription
cityType: string · query

Omit for all cities.

neighborhood_idType: integer[] · query

Neighborhood ids from GET /cities/{city}/neighborhoods. Only projects mapped to a neighborhood match.

developerType: string · query

Exact developer name, as returned by GET /developers.

property_typeType: string · query

Projects whose units listed on Kite are mostly of this type.

One of: apartment, villa, floor, duplex, land, building, office, shop

project_typeType: string · query

One of: off_plan, ready

listing_typeType: string · query

Which inventory to read: sale (the default) or rent units, where the source tells them apart, or all for both together. Rasan and Mada report only sale units, CompoundIn only rentals; Asas Makeen and Wasalt report both.

One of: sale, rent, all

group_byType: string · query

One group per city (the default), neighborhood, developer, property type or project type. Projects without a value for the grouping field are left out and counted in projects_ungrouped.

One of: city, neighborhood, developer, property_type, project_type

fromType: string · query

First month (YYYY-MM). Defaults to 2026-09, the month snapshots began (2026-09-26).

toType: string · query

Last month (YYYY-MM). Defaults to the current month. At most 24 months.

min_sample_sizeType: integer · query

A month's figures are null when fewer projects than this have a usable month.

Response

The data field is an object with these fields.

NameDescription
filtersrequiredType: object
listing_typerequiredType: string

One of: sale, rent, all

group_byrequiredType: string

One of: city, neighborhood, developer, property_type, project_type

fromrequiredType: string
torequiredType: string
min_sample_sizerequiredType: integer
projects_ungroupedrequiredType: integer
groupsrequiredType: object[]

Example request

cURL
curl "https://api.kite.sa/v1/market/absorption" \  -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.market.absorption();
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.market.absorption()

Open in the interactive reference

Related endpoints

  • Search projectsGET /projects
  • Get a projectGET /projects/{id}
  • List a project's unitsGET /projects/{id}/units
  • Get a project's unit availability over timeGET /projects/{id}/availability
  • Search project unitsGET /project-units
  • List developersGET /developers
  • Get a project's absorption by monthGET /projects/{id}/absorption

Guides

  • Quickstart
  • Searching and filtering
  • Limits and quotas
  • Pagination
  • 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