Get an Evlek listing
get_listingGet the full details of ONE public Evlek listing (sale or long-term rent) in the user's language. ref is the listing id (UUID), the listing number (EVL-100464 or just 100464) or an evlek.app listing link in any language. Returns the price, rooms, bathrooms, built area and plot area (always separate), the approximate location, features, the office name, dates, data-quality notes, photos with captions where they exist, AI virtual-staging before/after images when the office approved them (always labelled as AI-generated) and the canonical link. Contact details are never included: send the user to the link. A listing that is unknown or no longer public answers found:false with code NOT_FOUND (this is not an error). Pass the user's language as locale (tr, en, ru, de or ar).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ref": "<ref>"
},
"name": "get_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | The listing: its id (UUID), its listing number (EVL-100464 or 100464) or an evlek.app listing link in any language. | |
| 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 |
|---|---|---|---|
| id | No | ||
| ref | No | Short summary: listing number. | |
| url | No | The canonical link of the listing page in contentLocale. | |
| area | No | ||
| city | No | ||
| code | No | When found is false: NOT_FOUND (the listing does not exist or is not public), SEARCH_BACKEND_UNAVAILABLE, INVALID_PARAMS or INTERNAL_ERROR. | |
| dates | No | ||
| floor | No | ||
| found | Yes | ||
| media | No | ||
| price | No | ||
| rooms | No | ||
| title | No | ||
| issues | No | ||
| locale | No | ||
| office | No | ||
| photos | No | ||
| plotM2 | No | ||
| rental | No | ||
| areaSqm | No | The BUILT area in m², as the listing page shows it: null on land (see plotM2) and when the page withholds the figure (a plot-looking number on a small home, a closed area too small for its rooms); otherwise shown even when areaSuspect is true. A gross figure says so in areaBasis. | |
| areaText | No | ||
| bedrooms | No | ||
| currency | No | ||
| district | No | ||
| factType | No | ||
| features | No | ||
| listedAt | No | ||
| location | No | ||
| priceGbp | No | ||
| warnings | No | ||
| areaBasis | No | 'gross' when areaSqm is a gross figure (not the indoor area; no price per m² is derived from it); 'net' only when the publisher stated the area is net (Evlek does not measure it); null when the basis is not stated, or there is no built area. | |
| areaLabel | No | ||
| bathrooms | No | ||
| furnished | No | ||
| requested | No | The identifier the caller sent, when found is false. | |
| retryable | No | True when found is false because the search backend could not answer (code SEARCH_BACKEND_UNAVAILABLE). | |
| roomLabel | No | ||
| updatedAt | No | ||
| agencyName | No | Short summary: office name. | |
| dataSource | No | ||
| isEstimate | No | ||
| listingRef | No | ||
| officeName | No | ||
| photoCount | No | ||
| priceLabel | No | Short summary: printed price. | |
| areaSuspect | No | ||
| buildingAge | No | ||
| dataQuality | No | ||
| description | No | ||
| photosShown | No | ||
| titleSource | No | ||
| totalFloors | No | ||
| transaction | No | ||
| propertyType | No | ||
| contentLocale | No | The language the listing page and url really resolved to. | |
| coverImageUrl | No | ||
| listingNumber | No | ||
| localeFallback | No | ||
| monthlyRentGbp | No | ||
| pricePerSqmGbp | No | GBP per m², by the listing page's own rule: null whenever the built area is flagged suspect, withheld, or gross (areaBasis 'gross'), and on land below 150 m². | |
| virtualStaging | No | Present only when approved AI virtual-staging images exist. Every image is AI-generated and must be shown with the disclosure. | |
| photosTruncated | No | ||
| descriptionLocale | No | ||
| locationPrecision | No | ||
| propertyTypeLabel | No | ||
| titleGeneratedReason | No |