Skip to main content
GET
Search properties
Returns published, moderation-approved listings that match the given filters. Public — no authentication required.

Query parameters

string
Free-text query on title, description, city, and district.
string
City name in Arabic or English. Case-insensitive.
string
District name in Arabic or English.
string
Property type slug: villa, apartment, commercial-land, etc. See Locations for the full list.
number
Minimum price in SAR (inclusive).
number
Maximum price in SAR (inclusive).
integer
Minimum bedrooms.
integer
Maximum bedrooms.
number
Minimum area in square meters.
number
Maximum area in square meters.
integer
default:"20"
Results per page (1-50).
integer
default:"0"
Starting offset for pagination.

Response

array
Array of property objects. Each includes:
integer
Number of results returned (up to limit).
integer
Echoed offset for pagination.

Example