Property Sourcing
Find properties in the property graph, where every property is one record however many agencies and portals advertise it: search by structured filters or in plain language, page through the results, read one property with everywhere it is advertised and its price history, and resolve a portal or agency link or a reference to the property it belongs to. REST only.
REST API
5 operations on the platform's REST API, under https://platform.casafari.com with a platform API key (how to get one), billed in units (1 unit = EUR 0.04); and 5 operations on the existing REST API, under https://api.casafari.com with a bearer token (how to get one). The same list with more detail: Property Sourcing REST API.
Property Sourcing
Paths under /v1/property-sourcing.
/v1/property-sourcing/searchesSearch propertiesStructured search of the property graph: one request body for every country.POST/v1/property-sourcing/searches/describeSearch properties by descriptionPlain-language search: say what you look for as tags (up to 20 phrases) or one description (split into phrases at commas, semicolons and "and"), in the places named by…GET/v1/property-sourcing/searches/{cursor}Next page of a searchThe next page of a search: follow the next URL a search returned.GET/v1/property-sourcing/properties/{property_id}Get a propertyOne property by its prop_ id: the search result's fields plus bathrooms, areas, construction year, energy rating, condition, features, address, description and status.POST/v1/property-sourcing/properties/resolveResolve a link or reference to its propertySend exactly one of url (a portal or agency link to one home), reference (the reference an agency gives the home) or listing_id, and get back the property it belongs…On the existing REST API (api.casafari.com)
Paths under /api.
/api/v1/properties/match-by-listingsGet property by listing IDs (v1)Returns a mapping properties IDs to listing IDs.POST/api/v1/properties/searchSearch properties (v1)GET/api/v1/properties/search/{property_id}Get property by ID (v1)Returns a property object.POST/api/v1/properties/smart-linksCreate 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/searchSearch properties (v2)Pricing
| Operation | Units | EUR |
|---|---|---|
POST /v1/property-sourcing/searches | 100 units per page | 4.00 |
POST /v1/property-sourcing/searches/describe | 100 units per page | 4.00 |
GET /v1/property-sourcing/searches/{cursor} | 100 units per page | 4.00 |
GET /v1/property-sourcing/properties/{property_id} | 10 units | 0.40 |
POST /v1/property-sourcing/properties/resolve | 25 units | 1.00 |
1 unit = EUR 0.04. Free: 1,000 units for 30 days; pay as you go: prepaid credits; Agent: EUR 70 a month; Custom: talk to Casafari. See platform API keys.
What is Property Sourcing?
Property Sourcing is the REST search product of Casafari, the AI agent-native real estate data intelligence platform, for finding residential and commercial properties for sale or for rent in its deduplicated, cleaned property graph, where every property is one record with its full price and status history, however many agencies and portals advertise it. Built for AI agents as well as buyer's agents, agents prospecting for mandates, investors and proptech developers, it offers structured search, plain-language search, single-property reads and resolution of any portal or agency link or reference to its property. One request body works across Andorra, the United Arab Emirates, Austria, Belgium, Switzerland, Germany, Spain, France, Greece, Italy, Luxembourg, Monaco, Poland, Portugal, San Marino and the United States, on data from the most complete property index in Europe.
Use cases
Questions about Property Sourcing
- How do I find every property for sale in a town that matches my client's brief, without duplicates?
- Can I search by a plain-language description like 'sea view, needs renovation, near the beach'?
- Which properties in this area have the lowest price per square metre?
- How long has this property been on the market and what did it originally ask?
- Is this link my client sent the same property as the one I already have?
- How many agencies are advertising this property and at what prices?
- Can I filter by features like a rental licence, or exclude rented-out, life-annuity and business-transfer properties?
- What are the newest properties that came on the market in my area this week?
- Does the API return the seller's phone number or email?
- Does the same request work for Spain, France, Italy, Germany, Portugal and Greece?
- How many results can one search return and how do I page?
- What does a price of 0 mean in the results?
- How much does a search cost?
- Can an AI agent call this API directly with a user's prompt?
MCP and REST compared
Over MCP: 0 tools. Over REST: 10 operations. Available over REST only: MCP has no tool for it.
Details: MCP and REST compared.