Get listings by id

GET/listings/batch

Up to 100 listings in one call, in the order requested. Ids that are no longer active (sold, rented, removed, or merged as a duplicate) come back in missing_ids.

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

Parameters

Name	Type	Description
`ids`requiredquery	`integer[]`	Comma-separated listing ids.

Response

The data field is a list; each item has these fields.

Name	Type	Description
`id`required	`integer`
`url`required	`string`	The listing's page on kite.sa.
`title`required	`string \| null`	The advertiser's title, as posted. Null for sources that don't have titles (for example Aqar); use `headline` for display.
`headline`required	`string`	A short English description built from the listing's fields. Always present.
`description`required	`string \| null`	As posted (usually Arabic).
`description_en`required	`string \| null`	English translation, where available.
`listing_type`required	`string`
`listing_category`required	`string \| null`
`property_type`required	`string`
`price`required	`object`
`financing`required	`object`
`bedrooms`required	`integer \| null`
`bathrooms`required	`integer \| null`
`livings`required	`integer \| null`	Living rooms.
`area_sqm`required	`number \| null`
`floor`required	`string \| null`
`age_years`required	`integer \| null`
`furnished`required	`boolean \| null`
`amenities`required	`string[]`
`location`required	`object`
`compound_name`required	`string \| null`
`project_id`required	`integer \| null`	Off-plan project this unit belongs to, if linked.
`images`required	`string[]`	Image URLs on Kite's CDN.
`image_count`required	`integer`
`advertiser`required	`object`
`verified_by_source`required	`boolean \| null`	The source marks this ad as verified.
`source`required	`object`
`also_listed_on`required	`string[]`	Other sources carrying the same property. Kite shows one listing per property.
`first_seen_at`required	`string (date-time) \| null`	When Kite first saw the listing.
`updated_at`required	`string (date-time) \| null`	Last update at the source, or the last time Kite saw the listing if the source doesn't publish update times. Drives `updated_since` and the `updated_*` sorts.
`last_seen_at`required	`string (date-time) \| null`	Last time Kite confirmed the listing is live.
`days_on_market`required	`integer \| null`

Example request

curl

curl "https://api.kite.sa/v1/listings/batch?ids=128647%2C128650" \
  -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.listings.batch({ ids: [128647,128650] });

Python (kite-sa)

from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.listings.batch(ids=[128647,128650])

Open in the interactive reference

Related endpoints

Search listings GET /listings
Count listings GET /listings/count
Get a listing GET /listings/{id}
Get a listing's price history GET /listings/{id}/price-history

Guides

Listings