Search for properties on Unlisted that meet certain criteria. boundary_id should always be used unless doing a nation-wide search, and is obtained by using the autocomplete_tool. Returns up to 100 matches; use max_results only when the user asks for a specific count. When telling the user what you're doing, say "area" not "boundary", and "home" or "property profile" not "listing". Don't mention internal IDs or parameter names.
View input schema
{
"type": "object",
"properties": {
"beds": {
"description": "Minimum number of bedrooms",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 1
}
]
},
"baths": {
"description": "Minimum number of bathrooms",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 1
}
]
},
"stories": {
"description": "Number of stories/floors",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 1
}
]
},
"perks": {
"description": "Features and perks",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "string",
"enum": [
"accessible",
"arbor_pergola",
"arena",
"attic",
"balcony",
"barn",
"bath_house",
"boat_access",
"boat_house",
"boat_lift",
"bonus_room",
"breakfast_nook",
"breezeway",
"cabin",
"canopy",
"cellar",
"central_vacuum",
"community_rec_room",
"courtyard",
"deck",
"elevator",
"escalator",
"exercise_room",
"family_room",
"finished_basement",
"fire_sprinklers",
"fireplace",
"first_floor_bedroom",
"first_floor_laundry",
"game_room",
"garage",
"gazebo",
"golf_course_green",
"granary",
"great_room",
"green_house",
"guest_house",
"hobby_room",
"intercom",
"kennel",
"laundry_room",
"lean_to",
"loading_platform",
"media_room",
"milk_house",
"mobile_home_hookup",
"mud_room",
"office",
"outdoor_kitchen",
"overhead_door",
"patio",
"pergola",
"pole_structure",
"pond",
"pool",
"pool_house",
"porch",
"poultry_house",
"practice_green",
"quonset",
"rooftop_garden",
"rv_parking",
"safe_room",
"sauna",
"security_alarm",
"shed",
"silo",
"sitting_room",
"sound_system",
"sports_court",
"sprinklers",
"stable",
"storage_building",
"storm_shelter",
"storm_shutter",
"study",
"study_room",
"sunroom",
"tax_ex_disabled",
"tax_ex_senior",
"tax_ex_veteran",
"tax_ex_widow",
"tennis_court",
"universal_access",
"utility_building",
"utility_room",
"water_feature",
"wet_bar",
"wine_cellar"
]
}
}
]
},
"price_min": {
"description": "Minimum price ($)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"price_max": {
"description": "Maximum price ($)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"build_min": {
"description": "Minimum build year",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"build_max": {
"description": "Maximum build year",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"area_min": {
"description": "Minimum building area (ft²)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"area_max": {
"description": "Maximum building area (ft²)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"lot_area_min": {
"description": "Minimum lot area (acres)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"lot_area_max": {
"description": "Maximum lot area (acres)",
"anyOf": [
{
"type": "null"
},
{
"type": "number",
"minimum": 0
}
]
},
"min_last_sale_date": {
"description": "Minimum last sale date",
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"format": "date"
}
]
},
"max_last_sale_date": {
"description": "Maximum last sale date",
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"format": "date"
}
]
},
"include_null_last_sale": {
"description": "Include properties with no recorded sale date?",
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
}
]
},
"sort_type": {
"description": "Sort order for results. Use default unless the user specifies otherwise. default: ranked by Unlisted's overall relevance/quality score, heavily weighted by selling_soon_score (best match first); owner_updated_at: properties most recently updated by their owner first (active/engaged sellers); selling_soon_score: properties with the highest likelihood of going to market soon, first; likes: most-liked properties first; last_sale_date: most recently sold properties first (properties with no sale date are excluded).",
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"enum": [
"default",
"owner_updated_at",
"selling_soon_score",
"likes",
"last_sale_date"
]
}
]
},
"boundary_id": {
"description": "Filter results to properties within a named geographic area (city, county, neighborhood, school district, etc.). Obtained from the autocomplete_tool.",
"anyOf": [
{
"type": "null"
},
{
"type": "number"
}
]
},
"geometry": {
"description": "GeoJSON Polygon to spatially filter properties. This is handy for when a boundary id is not found, or for other special cases where the user describes an area that is not well-known, or does not have a proper name.Coordinates are [longitude, latitude] pairs; first and last point must match to close the ring. Can be combined with boundary_id — results must satisfy both constraints. Example: {\"type\":\"Polygon\",\"coordinates\":[[[-87.635560,41.885830],[-87.628755,41.885842],[-87.628685,41.879399],[-87.635509,41.879389],[-87.635560,41.885830]]]}",
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"enum": [
"Polygon"
]
},
"coordinates": {
"type": "array",
"description": "Array of linear rings; first ring is the outer boundary",
"items": {
"type": "array",
"minItems": 4,
"items": {
"type": "array",
"description": "[longitude, latitude]",
"minItems": 2,
"maxItems": 2,
"items": {
"type": "number"
}
}
}
}
}
}
]
},
"style": {
"description": "Architectural style(s) to filter by",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "string",
"enum": [
"art_deco",
"bungalow",
"cape_cod",
"colonial",
"contemporary",
"craftsman",
"creole",
"dutch_colonial",
"federal",
"french_provincial",
"georgian",
"gothic_revival",
"greek_revival",
"international",
"italianate",
"monterey",
"national",
"neoclassical",
"mcm_prairie",
"pueblo",
"queen_anne",
"ranch",
"regency",
"saltbox",
"second_empire",
"shed",
"shingle",
"shotgun",
"spanish_eclectic",
"split_level",
"stick",
"tudor",
"victorian",
"other"
]
}
}
]
},
"max_results": {
"description": "Cap the total number of results shown to the user. Only use when the user explicitly asks for a specific count, e.g. 'show me the top 5' or 'give me 20 homes'. Must be 100 or fewer. Leave blank for normal searches.",
"anyOf": [
{
"type": "null"
},
{
"type": "integer",
"minimum": 1,
"maximum": 100
}
]
},
"property_use_standardized": {
"description": "Filter by property use type. Each item can be a category name (selects all codes in the group) or an individual ATTOM numeric code to cherry-pick. If omitted, all standard residential types are included. Categories and their codes — single_family [181,363,364,380,383,385,440,467,468]: SFR, cluster homes, rural residences, homesteads, ADU; condos_and_townhouses [366,376,377,379,382,386,390,416,421,452]: condos, PUDs, patio homes, row houses, townhouses, garden homes, zero lot line; coops [367,461]: cooperatives; manufactured [371,373]: mobile/manufactured/modular homes; multi_24 [369,372,378,388,469,470]: 2-4 unit multifamily (duplexes, triplexes, quads, generic multifamily); multi_5 [360,374,381]: apartments and large multifamily/income properties; misc [375,384]: seasonal/cabin/vacation + miscellaneous residential; vacant_land [398,401,453,462]: residential vacant land and uninhabitable/destroyed structures; other [171,254,306,368,370,387,402,447]: mixed-use, historical, dormitories, fraternity/sorority houses, timeshares, under construction, tiny houses, unknown.",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"enum": [
"single_family",
"condos_and_townhouses",
"coops",
"manufactured",
"misc",
"multi_24",
"multi_5",
"other",
"vacant_land"
]
},
{
"type": "integer"
}
]
}
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}