Compare Evlek listings
compare_listingsCompare 2 to 4 public Evlek listings side by side in the user's language: price, price per m² (only when the built area is believable), rooms, bathrooms, built area and plot area (always separate), location, furnishing, key features and data-quality notes, plus a few descriptive highlights (lowest price, largest indoor area, most recently listed). ids takes listing ids (UUID), listing numbers (EVL-100464) or evlek.app listing links, in any mix; the order you give is kept. Sale and rent listings are never ranked against each other: a mixed request is shown in two groups with a warning. A reference that is unknown or no longer public is listed in missingIds with code NOT_FOUND (this is not an error). Descriptive facts only: no valuation and no recommendation. Pass the user's language as locale (tr, en, ru, de or ar).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 2 to 4 listings, in any mix of ids, numbers and links. The order is kept. | |
| locale | No | Language of the answer and of the links. Pass the language the user writes in. Default en. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Absent on a comparison. NOT_ENOUGH_LISTINGS when fewer than two of the requested listings are available; SEARCH_BACKEND_UNAVAILABLE, INVALID_PARAMS or INTERNAL_ERROR otherwise. | |
| count | No | ||
| groups | No | The compared listings by transaction (sale and rent are never ranked against each other). | |
| issues | No | ||
| locale | Yes | ||
| missing | No | ||
| compared | Yes | The listings that were compared, in the order of the request. | |
| insights | Yes | ||
| warnings | Yes | ||
| retryable | No | True when the search backend could not answer (code SEARCH_BACKEND_UNAVAILABLE). | |
| dataSource | No | ||
| isEstimate | No | ||
| metricType | No | ||
| missingIds | Yes | One NOT_FOUND entry per requested reference that names no public listing. | |
| contentLocale | No | The language every link resolved to; null when the listings differ (see compared[].contentLocale). | |
| localeFallback | No | True when at least one link opens a page in another language than requested. |