Searches the live EVS catalogue of homes for sale, long-term rentals and new builds in Málaga province and on the Costa del Sol (Spain) with exact filters. Returns the number of matches, up to 10 listings (price, size, area, highlights, photo, link to the listing page in the requested language) and search_url — the same search on evsproperty.com with every match. Place names can be written in any language or spelling (municipality, district or urbanisation: 'Marbella', 'Nueva Andalucía', 'La Cala de Mijas', 'Málaga'); list_locations shows the places covered. Rental prices are per month. keywords matches words in the Spanish or English listing text (e.g. 'renovated', 'sea front promenade'). Listing links and search_url are meant to be shown to the user exactly as returned, including their query parameters.
View input schema
{
"type": "object",
"properties": {
"location": {
"anyOf": [
{
"items": {
"maxLength": 80,
"type": "string"
},
"maxItems": 5,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Up to 5 place names. Omit for the whole province / Costa del Sol.",
"title": "Location"
},
"deal": {
"default": "buy",
"description": "buy = for sale (resale and new builds); rent = long-term rental",
"enum": [
"buy",
"rent"
],
"title": "Deal",
"type": "string"
},
"new_build_only": {
"default": false,
"description": "Only new developments (obra nueva, off-plan or key-ready)",
"title": "New Build Only",
"type": "boolean"
},
"property_types": {
"anyOf": [
{
"items": {
"enum": [
"apartment",
"ground_floor_apartment",
"middle_floor_apartment",
"top_floor_apartment",
"penthouse",
"duplex",
"studio",
"house",
"villa",
"townhouse",
"semi_detached_house",
"country_house",
"bungalow",
"plot",
"commercial",
"building",
"parking_or_storage"
],
"type": "string"
},
"maxItems": 6,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Any of these types",
"title": "Property Types"
},
"price_min": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "EUR (per month for rent)",
"title": "Price Min"
},
"price_max": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "EUR (per month for rent)",
"title": "Price Max"
},
"bedrooms_min": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bedrooms Min"
},
"bedrooms_max": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bedrooms Max"
},
"bathrooms_min": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bathrooms Min"
},
"built_area_min": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "m²",
"title": "Built Area Min"
},
"built_area_max": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "m²",
"title": "Built Area Max"
},
"plot_area_min": {
"anyOf": [
{
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "m²",
"title": "Plot Area Min"
},
"features": {
"anyOf": [
{
"items": {
"enum": [
"sea_view",
"panoramic_view",
"mountain_view",
"golf_view",
"beachfront",
"beachside",
"near_sea",
"pool",
"private_pool",
"communal_pool",
"heated_pool",
"garden",
"private_garden",
"terrace",
"garage",
"parking",
"lift",
"air_conditioning",
"underfloor_heating",
"fireplace",
"furnished",
"unfurnished",
"gated_community",
"security_24h",
"gym",
"sauna_or_jacuzzi",
"near_golf",
"frontline_golf",
"near_shops",
"near_schools",
"near_transport",
"near_marina",
"storage_room",
"guest_apartment",
"reduced_mobility",
"solar_panels",
"ev_charger",
"smart_home",
"tennis_or_padel",
"south_facing",
"renovated",
"needs_renovation",
"luxury",
"price_reduced"
],
"type": "string"
},
"maxItems": 6,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "All of these must be present",
"title": "Features"
},
"keywords": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Words to find in the listing text (Spanish or English)",
"title": "Keywords"
},
"sort": {
"default": "recommended",
"description": "recommended = EVS's own listings first, then newest",
"enum": [
"recommended",
"newest",
"price_asc",
"price_desc",
"largest"
],
"title": "Sort",
"type": "string"
},
"language": {
"default": "en",
"description": "Language of the user: titles and links are returned in it",
"enum": [
"es",
"en",
"ru",
"de",
"fr",
"nl",
"sv",
"no",
"pl"
],
"title": "Language",
"type": "string"
},
"limit": {
"default": 6,
"maximum": 10,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"title": "search_propertiesArguments"
}