Use cases and worked examples · FAQ
How do I look up one property and its price history?
Use the REST API: GET /api/v1/properties/search/{property_id} returns a single property with its history, and POST /api/v1/properties/match-by-listings resolves an ad id from a portal or agency to its property.
- If you have an ad id from a portal or agency site, call
POST /api/v1/properties/match-by-listingsto find the property it belongs to. - If you have a property id, call
GET /api/v1/properties/search/{property_id}. The record includessale_price_historyandrent_price_history, with dates and statuses such as active, reserved, hold, sold and rented. - To find properties, use
POST /api/v2/properties/searchwith structured filters. - To share a property, create a smart link with
POST /api/v1/properties/smart-links(BETA).
No MCP tool is available for this.
See: Properties and The property graph.
Where this is documented
- Get property by listing IDs (v1)
- Get property by ID (v1)
- Search properties (v2)
- Create a smart link (BETA) (v1)
- Properties
- The property graph
Related questions
- How do I value a home or find comparables with Casafari MCP?
- How do I analyse how prices in an area have moved over time?
- How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?
- Can I build a market report with Casafari MCP?
- How do I find agencies or agents to partner with in a German city?