estimate_value
Estimate the market value of an apartment from comparable registered transaction prices near a point. Requires usable area in m² and location by coordinates or parcel ID.
Instructions
[Beta] Estimate the market value of an apartment from comparable registered transaction prices near a point. An orientation estimate, NOT a certified appraisal (operat szacunkowy) — it does not account for the unit's condition, finish standard or floor, and does not replace a surveyor's valuation. Address by lat + lng (a point on the map) OR parcelId (a full cadastral id or internal UUID; the parcel centroid is used) — exactly one. area (usable area in m², 10–250) is REQUIRED: there is no per-address floor-area source in Poland, so the caller supplies it. Optional: rooms (1–10) and market (primary/secondary) narrow the comparables; includeComps (default true) echoes the nearest comparables it weighed. Returns the point estimate, a likely and a wide value range, a confidence band, the comparable count, and an as_of date. as_of reflects transaction-data freshness, which lags by county — estimates are NOT directly comparable across cities with different as_of. Apartments only (v1), 10–250 m². Too few comparables near the point → no estimate (the credit is refunded). Costs 5 API tokens, refunded when no estimate is produced. Note: median/average prices are market-based — fractional ownership shares and non-market deeds (public tenders, foreclosures, privileged/subsidized sales) are excluded from price aggregates. Transaction counts and coverage stay complete.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude of the apartment (WGS84, Poland). Must be paired with lng. Use this OR parcelId. | |
| lng | No | Longitude of the apartment (WGS84, Poland). Must be paired with lat. Use this OR parcelId. | |
| area | Yes | Apartment usable area in m² (REQUIRED, 10–250). Estimates for 300+ m² are unreliable and rejected. | |
| rooms | No | Room count (1–10, optional) — narrows the comparables to ±1 room. | |
| market | No | Restrict comparables to the primary (new-build) or secondary market (optional). | |
| parcelId | No | Full cadastral id (slash or dash form) or internal UUID; the parcel centroid is used. Use instead of lat/lng. | |
| includeComps | No | Echo the nearest comparables the estimate weighed (default true). Set false for the estimate only. |