# How do I build on the Casafari REST API?

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

The Casafari REST API lives at `https://api.casafari.com`. It has 39 operations and no gateway, uses a JWT from `POST /login`, and publishes a public OpenAPI description at https://docs.api.casafari.com/openapi.json.

1. Read the OpenAPI document for the base catalogue. After you sign in, https://docs.api.casafari.com/ shows your account's own operations.
2. Call [`POST /login`](https://platform.casafari.com/docs/rest/authentication/login) with your email and password, send the access token as a bearer token, and renew it with [`GET /refresh-token`](https://platform.casafari.com/docs/rest/authentication/refresh-token).
3. Build reference lookups from [References](https://platform.casafari.com/docs/references), then call the product operations you need: Properties, Comparables & Valuation, Area Insights and Alerts.

[MCP and REST compared](https://platform.casafari.com/docs/parity) shows what exists only over REST, such as Properties and Alerts, and only over MCP, such as AgentGraph AI. The API also appears in the hub's [API catalog](https://platform.casafari.com/.well-known/api-catalog).

See: [REST API](https://platform.casafari.com/docs/rest).

## Where this is documented

- [Login](https://platform.casafari.com/docs/rest/authentication/login)
- [Refresh Token](https://platform.casafari.com/docs/rest/authentication/refresh-token)
- [References](https://platform.casafari.com/docs/references)
- [MCP and REST compared](https://platform.casafari.com/docs/parity)
- [/.well-known/api-catalog](https://platform.casafari.com/.well-known/api-catalog)
- [REST API](https://platform.casafari.com/docs/rest)

## Related questions

- [How do I value a home or find comparables with Casafari MCP?](https://platform.casafari.com/docs/faq/example-valuation)
- [How do I analyse how prices in an area have moved over time?](https://platform.casafari.com/docs/faq/example-price-trend)
- [How do I see how properties are distributed by price, bedrooms or time on market, or get a heatmap?](https://platform.casafari.com/docs/faq/example-distributions-heatmap)
- [Can I build a market report with Casafari MCP?](https://platform.casafari.com/docs/faq/example-market-report)
- [How do I find agencies or agents to partner with in a German city?](https://platform.casafari.com/docs/faq/example-find-agencies-germany)

All questions: https://platform.casafari.com/docs/faq#build-on-rest