A Sava disponibiliza uma API de leitura e um endpoint MCP para produtos, chatbots e ferramentas de pesquisa que precisam consultar novos projetos residenciais em Portugal.
Os dados incluem nome do projeto, localizacao, coordenadas, tipologias, comodidades como ginasio, piscina, estacionamento, spa ou sauna, intervalos de preco e area, ano de conclusao, promotor quando conhecido, imagem, pisos, unidades totais, tempos estimados ate praia, aeroporto e escolas internacionais, infraestrutura em ate 15 minutos a pe, alem de disponibilidade atual, fotos, imagens oficiais e links de plantas quando houver dados de origem.
REST API
Use endpoints HTTP simples para pesquisar projetos, abrir detalhes por slug, listar municipios, consultar disponibilidade e baixar a especificacao 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=pt{
"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=pthttps://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=ptMCP
Use JSON-RPC em /api/mcp/ para expor as mesmas operacoes a assistentes e agentes compativeis com ferramentas.
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=pthttps://sava.pt/api/v1/openapi.json| Metodo | Path | Uso | Parametros |
|---|---|---|---|
GET | /api/v1/projects | Pesquisar projetos por filtros, incluindo region_group, comodidades, infraestrutura em 15 minutos a pe e disponibilidade. A resposta inclui coordenadas, imagem, pisos, unidades totais, tempos de deslocacao, amenities, walking_access_15_summary e resumo de disponibilidade quando houver unidades atuais. | 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} | Obter detalhes completos de um projeto, incluindo available_units quando houver dados. | slug, locale |
GET | /api/v1/projects/{slug}/media | Obter fotos/imagens do projeto e links de plantas quando houver dados de origem. | slug, locale |
GET | /api/v1/projects/{slug}/available-units | Obter disponibilidade atual de unidades, precos, piso/quartos e links de plantas quando houver dados de origem. | slug, locale |
GET | /api/v1/locations | Listar regioes e municipios disponiveis, com slugs e URLs /cities/. | limit |
GET | /api/v1/facets | Listar filtros disponiveis, comodidades, tipologias, anos de conclusao e intervalos numericos. | - |
GET | /api/v1/openapi.json | Baixar a especificacao OpenAPI. | - |
POST | /api/mcp/ | Chamar ferramentas MCP via 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 |