# Properties 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).

Search the property graph, where every property is one record with its price and status history. Over REST: search by structured filters, fetch a property and its history by id, resolve a portal or agency ad id to the property it belongs to, create shareable links.

5 operations, from the public OpenAPI description. Base URL `https://api.casafari.com`; every operation but sign-in needs a bearer token (see [the REST API overview](/docs/rest#get-a-token)).

Over MCP, Properties has no tools: see [MCP and REST compared](/docs/parity#properties).

## Operations

- [`POST /api/v1/properties/match-by-listings`](/docs/rest/properties/get-property-by-listing-ids-v1): Get property by listing IDs (v1). Returns a mapping properties IDs to listing IDs.
- [`POST /api/v1/properties/search`](/docs/rest/properties/search-properties-v1): Search properties (v1)
- [`GET /api/v1/properties/search/{property_id}`](/docs/rest/properties/get-property-by-id-v1): Get property by ID (v1). Returns a property object.
- [`POST /api/v1/properties/smart-links`](/docs/rest/properties/create-a-smart-link-beta-v1): Create a smart link (BETA) (v1). Generates a smart link that provides detailed property information with customizable components, branding, and user/company information overrides.
- [`POST /api/v2/properties/search`](/docs/rest/properties/search-properties-v2): Search properties (v2)

## Questions about this

- [Can I search properties over Casafari MCP?](/docs/faq/properties-over-mcp)