Use cases and worked examples · FAQ
How do I turn a place name into a location id?
Use a location lookup to turn a place name into location ids, then pass those ids to the operations that need them.
If you're a Casafari client: over the Casafari REST API, POST /api/v1/references/locations/typeahead is scoped to ES or PT. GET /api/v1/references/locations/by-coordinates resolves a point, and POST /api/v1/references/locations reads the location tree. Over MCP, use Location Lookup on the self-serve platform like everyone else (below).
If you're new to Casafari: use Location Lookup on the self-serve platform, over MCP at https://platform.casafari.com/mcp/locations (locations_search finds places by name, locations_get fetches one) or REST at https://platform.casafari.com/v1/locations. locations_search is also on the Area Insights MCP server, so a single Area Insights connector can find ids itself. Searching by name, fetching a place, reading its children and resolving coordinates all cost 0 tokens, for example GET https://platform.casafari.com/v1/locations/search?query=Lisbon. The ids work with the Area Insights tools.
comparables_get_comparablesneeds no id: it takes coordinates, an address or a cadastral reference.
See: Area Insights and References.
Where this is documented
- Get locations typeahead suggestions scoped by country code (v1)
- Get location by passed coordinates (v1)
- Get locations (v1)
- References
- Area Insights