create_search_profile
Converts a buyer's or renter's natural language property requirements into a structured search profile for a contact in Propstack, enabling automated matching with available properties.
Instructions
Create a search profile (Suchprofil) for a contact in Propstack.
This is THE killer feature for an AI real estate assistant. When a buyer or renter describes what they're looking for in natural language, map it to structured search criteria:
Example conversation: "Herr Weber sucht eine 3-Zimmer-Wohnung in Berlin oder Potsdam, Budget 300.000–400.000 €, muss einen Balkon haben" → client_id: <Herr Weber's ID> marketing_type: "BUY" rs_types: ["APARTMENT"] cities: ["Berlin", "Potsdam"] number_of_rooms: 3, number_of_rooms_to: 3 price: 300000, price_to: 400000 balcony: "true"
Mapping guide:
"Wohnung" / "apartment" → rs_types: ["APARTMENT"]
"Haus" / "house" → rs_types: ["HOUSE"]
"kaufen" / "buy" → marketing_type: "BUY"
"mieten" / "rent" → marketing_type: "RENT"
"3 Zimmer" → number_of_rooms: 3, number_of_rooms_to: 3
"3-4 Zimmer" → number_of_rooms: 3, number_of_rooms_to: 4
"bis 400k" → price_to: 400000
"mind. 80m²" → living_space: 80
"mit Balkon" → balcony: "true"
"mit Aufzug" → lift: "true"
"mit Garten" → garden: "true"
"mit EBK" → built_in_kitchen: "true"
"Neubau" → construction_year: 2020
Feature booleans use strings: "true" = required, "false" = excluded, omit = don't care.
Use radius search (lat/lng/radius) for "within 5km of Alexanderplatz".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude for radius search center | |
| lng | No | Longitude for radius search center | |
| lift | No | Lift/elevator required: 'true', 'false', or omit for any | |
| note | No | Free-text note about this search profile | |
| floor | No | Minimum floor | |
| price | No | Minimum purchase price (EUR) | |
| active | No | Whether the search profile is active (default: true) | |
| cellar | No | Cellar required: 'true', 'false', or omit for any | |
| cities | No | City names to search in (e.g. ['Berlin', 'Potsdam']) | |
| garden | No | Garden required: 'true', 'false', or omit for any | |
| radius | No | Search radius in meters from lat/lng center | |
| rented | No | Currently rented: 'true', 'false', or omit for any | |
| balcony | No | Balcony required: 'true', 'false', or omit for any | |
| regions | No | Region names to search in | |
| floor_to | No | Maximum floor | |
| price_to | No | Maximum purchase price (EUR) | |
| rs_types | No | Property types (e.g. ['APARTMENT', 'HOUSE']) | |
| base_rent | No | Minimum base rent (EUR/month) | |
| client_id | Yes | Contact ID this search profile belongs to (required) | |
| group_ids | No | Tag/group IDs to assign | |
| plot_area | No | Minimum plot area (m²) | |
| total_rent | No | Minimum total rent (EUR/month) | |
| base_rent_to | No | Maximum base rent (EUR/month) | |
| living_space | No | Minimum living space (m²) | |
| location_ids | No | Propstack location/district IDs | |
| plot_area_to | No | Maximum plot area (m²) | |
| yield_actual | No | Minimum actual yield (%) | |
| price_per_sqm | No | Minimum price per m² (EUR) | |
| rs_categories | No | Property categories (e.g. ['APARTMENT_NORMAL', 'HOUSE_DETACHED']) | |
| total_rent_to | No | Maximum total rent (EUR/month) | |
| marketing_type | No | Marketing type: BUY (Kauf) or RENT (Miete) | |
| living_space_to | No | Maximum living space (m²) | |
| number_of_rooms | No | Minimum number of rooms | |
| yield_actual_to | No | Maximum actual yield (%) | |
| built_in_kitchen | No | Built-in kitchen required: 'true', 'false', or omit for any | |
| price_multiplier | No | Minimum price multiplier (Vervielfältiger) | |
| price_per_sqm_to | No | Maximum price per m² (EUR) | |
| construction_year | No | Minimum construction year | |
| number_of_rooms_to | No | Maximum number of rooms | |
| number_of_bed_rooms | No | Minimum number of bedrooms | |
| price_multiplier_to | No | Maximum price multiplier | |
| construction_year_to | No | Maximum construction year | |
| number_of_bed_rooms_to | No | Maximum number of bedrooms |