Sava ofrece una API de solo lectura y un endpoint MCP para productos, chatbots y herramientas de investigación que necesitan acceso estructurado a proyectos residenciales de obra nueva en Portugal.
El conjunto de datos incluye nombres de proyectos, ubicaciones, coordenadas, tipologías, servicios como gimnasio, piscina, aparcamiento, spa o sauna, rangos de precios y superficies, año de entrega, promotor cuando se conoce, imágenes, plantas, número total de unidades, tiempos estimados hasta la playa, el aeropuerto y colegios internacionales, servicios a 15 minutos a pie, disponibilidad actual, fotos, imágenes oficiales y enlaces a planos cuando las fuentes los proporcionan.
REST API
Utiliza endpoints HTTP sencillos para buscar proyectos, abrir detalles por slug, listar municipios, obtener tablas de disponibilidad y consultar la especificación OpenAPI.
https://sava.pt/api/v1/projects?municipality=Lisboa&typology=T2&amenity=gym,pool&has_parking=true&walk_15_category=supermarket,park&max_price=700000&limit=3&locale=es{
"items": [
{
"name": "1965 Cidade Jardim",
"municipality": "Loures",
"typologies": ["T1", "T2", "T3"],
"price_min": 350000,
"image_count": 3,
"floorplan_count": 2,
"amenities": ["gym", "pool", "parking"],
"amenities_flags": {
"gym": true,
"pool": true,
"parking": true,
"spa_sauna": false
},
"walking_access_15_summary": {
"has_data": true,
"categories_count": 5,
"total_places": 32,
"category_counts": {
"supermarket": 4,
"park": 2,
"metro": 1
}
},
"available_units_summary": {
"has_available_units": true,
"available_units_count": 12,
"available_typologies": ["T2", "T3"],
"available_price_min": 369000,
"floorplan_count": 4
}
}
]
}https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=eshttps://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=esMCP
Utiliza JSON-RPC en /api/mcp/ para ofrecer las mismas operaciones a asistentes y agentes compatibles con herramientas.
curl -X POST https://sava.pt/api/mcp/ \
-H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'https://sava.pt/api/v1/projects/1965-cidade-jardim/media?locale=eshttps://sava.pt/api/v1/openapi.json| Método | Ruta | Finalidad | Parámetros |
|---|---|---|---|
GET | /api/v1/projects | Busca proyectos por filtros, incluidos region_group, servicios, infraestructura a 15 minutos a pie y disponibilidad. La respuesta incluye coordenadas, imagen, plantas, unidades totales, tiempos de viaje, servicios, walking_access_15_summary y un resumen de disponibilidad cuando se conocen las unidades actuales. | region_group, municipality, locality, typology, property_type, amenity, has_gym, has_pool, has_parking, has_spa_sauna, walk_15_category, min_walk_15_categories, min_walk_15_places, has_walk_15_supermarket, has_walk_15_park, has_walk_15_metro, min_price, max_price, min_area, max_area, completion_year, max_beach_drive_minutes, max_airport_drive_minutes, max_school_drive_minutes, max_school_walk_minutes, min_total_units, has_available_units, available_typology, max_available_price, min_bedrooms, max_bedrooms, locale, limit |
GET | /api/v1/projects/{slug} | Obtén todos los detalles del proyecto, incluidas las available_units cuando se conozcan. | slug, locale |
GET | /api/v1/projects/{slug}/media | Obtén fotos, imágenes y enlaces a planos cuando estén disponibles en las fuentes. | slug, locale |
GET | /api/v1/projects/{slug}/available-units | Obtén la disponibilidad actual, precios, datos de plantas y dormitorios y enlaces a planos cuando estén disponibles. | slug, locale |
GET | /api/v1/locations | Lista las regiones y municipios disponibles, con slugs y URL de /cities/. | limit |
GET | /api/v1/facets | Lista los filtros, servicios, tipologías, años de entrega y rangos numéricos disponibles. | - |
GET | /api/v1/openapi.json | Obtén la especificación OpenAPI. | - |
POST | /api/mcp/ | Llama a las herramientas MCP mediante JSON-RPC. | search_new_build_projects, get_new_build_project, get_new_build_project_available_units, get_new_build_project_media, list_new_build_locations, get_new_build_facets |