Get one premises
claro_get_premisesOne premises in full by the id a search returned: its data, the facts read from its text with the sentence each came from, its coordinates, up to 8 photos, its asking-price timeline, whether it is still on the market and the agency's own ad links. insights adds charts as data: asking prices against comparable premises nearby, nearby businesses, supply and time on the market, and Location Intelligence ranks when the plan includes it. assessment, with insights, adds an AI-written site assessment whose every number is checked against those figures. On the Free plan, only for ids your searches returned. Costs 25 tokens a call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | A premises id (pm_...) from a search result. | |
| lang | No | Language of the text the answer writes (titles, notes, labels, reasons, error messages): en (default) or de (German). Place names, agency names, property titles and quotes from a property's own text stay as written. | en |
| insights | No | ||
| segments | No | Optional, with insights: the business kinds whose distances come first in the distances chart, usually the brief's competitors (for a coffee shop: coffee and bakery). Without it the chart keeps its default order. | |
| assessment | No | With insights: add `site_assessment` first, a site assessment written by Gemini from this premises' own figures only (its data, its facts with their quotes, the market and competition charts, its parcel's zoning when `parcel_zoning` has an answer, its parcel's Cadastre record when `cadastre` has one (the register beside the advertised figures, with no verdict), and with location access the location figures and ranks): 3 to 5 summary sentences, strengths and watch-outs, and a verdict (strong, fair, weak, not_assessable) for quick-service restaurants, coffee and bakery, clinic and pharmacy, fitness, fashion and retail, and supermarket and convenience, each reason with the keys of the figures it rests on. Every number is checked against those figures and a sentence that fails is dropped (counted in `notes`); a missing figure is not stated, never a weakness. `scope` is with_location or listing_only. Stored per premises and inputs; the first request for new inputs waits for the model. |