search
Find published off-plan UAE developments by project name or slug text, combined with exact structured filters. Returns shortlist facts and a pagination cursor. Follow more pages only when the user's task needs them; a page's result count is not a total. Use suggest project terms for a partial facet name, list project facets to explore all filter choices, and fetch for selected project detail. A known project URL or slug can go straight to fetch . Prices and price filters apply to the whole development. They do not establish that a particular bedroom count, property type, or unit is available a
Показать схему аргументов
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"area": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"description": "Exact public API area slug from list_project_facets, for example dubai-marina."
},
"sort": {
"enum": [
"recommended",
"price-asc",
"price-desc",
"handover-asc",
"handover-desc"
],
"type": "string",
"description": "Sort value from list_project_facets."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Maximum results to return. Defaults to 10."
},
"query": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 160,
"minLength": 2,
"description": "Literal text within a project name or slug; ASCII letter case is ignored. Use structured filters for location, budget and other criteria; this does not interpret natural-language requests."
},
"cursor": {
"type": "string",
"maxLength": 2048,
"description": "Pagination cursor returned by a previous search call."
},
"emirate": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"description": "Exact public API emirate slug from list_project_facets, for example dubai."
},
"developer": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"description": "Exact public API developer slug from list_project_facets, for example sobha-realty."
},
"newLaunch": {
"type": "boolean",
"description": "Filter for projects marked as new launches."
},
"comingSoon": {
"type": "boolean",
"description": "Filter for projects marked as coming soon."
},
"bedroomsMin": {
"type": "integer",
"maximum": 20,
"minimum": 0,
"description": "Return developments advertising a bedroom count at or above this value. Zero leaves the filter unset; it does not select studios or identify a unit at a particular price."
},
"priceMaxAed": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1,
"description": "Upper bound of the desired development-wide price interval. A development matches when its known range starts at or below this amount; unknown pricing is excluded."
},
"priceMinAed": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1,
"description": "Lower bound of the desired development-wide price interval. A development matches when its known range reaches this amount or above; unknown pricing is excluded."
},
"availability": {
"enum": [
"available",
"limited",
"sold-out"
],
"type": "string",
"description": "Availability filter from list_project_facets."
},
"handoverYear": {
"type": "integer",
"maximum": 2200,
"minimum": 1900,
"description": "Expected handover year."
},
"propertyType": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"description": "Exact public API property type slug from list_project_facets, for example apartment."
}
},
"additionalProperties": false
}