Get a project's absorption by month (GET /projects/{id}/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

Get a project's absorption by month

GET/projects/{id}/absorption

How fast a project's offered units go, per calendar month: units on offer at the start and end, units gone, units re-added and released, the absorption rate (units gone ÷ units at the start), and months of stock left at that pace. Each month carries a reliability and the flags behind it; the project carries history_days and an overall reliability.

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.

What is left out. Movement that isn't the market is excluded from units_gone and named in each month's flags: readings more than 8 days apart (gap), the whole inventory vanishing at once without being marked sold or reserved (withdrawal), a day on which 40% or more of one source's projects changed (source_change), and, on unit tables, units that leave the table without being marked sold or reserved (units_removed). A project going inactive or a source dropping it ends its series; it is never read as a sell-out. Units appearing are reported as units_released (a new phase) or units_re_added, never netted against units gone.

Returns 404 for inactive projects and for copies merged into another project; GET /projects/{id}/availability has the raw daily snapshots.

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

Parameters

NameDescription
idrequiredType: integer · path

Project id.

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

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.

Response

The data field is an object with these fields.

NameDescription
project_idrequiredType: integer
listing_typerequiredType: string

One of: sale, rent, all

fromrequiredType: string
torequiredType: string
basisrequiredType: string | null

What the inventory count is: unit_status (the source lists every unit with a status), reported_available (the source states an available count), listed_units (units listed on the project's page). Null when no source of this project reports inventory.

basis_sourcerequiredType: string | null

The source the series is read from.

reliabilityrequiredType: string

usable: at least one usable month. short_history: readings, but no usable month yet (too short, gaps, or nothing on offer). no_inventory_signal: no source of this project reports an inventory count for this listing_type.

One of: usable, short_history, no_inventory_signal

history_daysrequiredType: integer

Days from the first to the last reading of the series.

first_observedrequiredType: string | null
last_observedrequiredType: string | null
readingsrequiredType: integer

Days with an inventory reading.

latest_availablerequiredType: integer | null

Units on offer at the last reading.

usable_monthsrequiredType: integer
units_gone_per_monthrequiredType: number | null

Pace over the last (up to) three usable months, units a month.

months_of_stockrequiredType: number | null

latest_available ÷ units_gone_per_month. Null when nothing went.

monthsrequiredType: object[]

Example request

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

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
  • Project absorption by area, developer or typeGET /market/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