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, disponibilidade atual, fotos, imagens oficiais, links de plantas, previsao de preco €/m² do projeto a 12/24 meses e analitica de preco €/m² por geo.

REST API

Use endpoints HTTP simples para pesquisar projetos, abrir detalhes por slug, listar municipios, consultar disponibilidade, consultar analitica de mercado por geo e baixar a especificacao OpenAPI.

Endpoint
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
Exemplo de resposta JSON
{
  "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
      }
    }
  ]
}
Endpoint
https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=pt
Endpoint de disponibilidade
https://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=pt
Analitica de mercado
https://sava.pt/api/v1/market?query=Cascais&level=municipality&months=120&limit=5

MCP

Use JSON-RPC em /api/mcp/ para expor as mesmas operacoes a assistentes e agentes compativeis com ferramentas, incluindo analitica de mercado por geo.

curl MCP
curl -X POST https://sava.pt/api/mcp/ \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Endpoint de media
https://sava.pt/api/v1/projects/1965-cidade-jardim/media?locale=pt
OpenAPI
https://sava.pt/api/v1/openapi.json
Endpoints
MetodoPathUsoParametros
GET/api/v1/projectsPesquisar 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 e market_forecast: preco €/m² atual do projeto, previsao de preco e crescimento a 12/24 meses, localizacao do calculo e base CAGR de 5 anos.slug, locale
GET/api/v1/projects/{slug}/mediaObter fotos/imagens do projeto e links de plantas quando houver dados de origem.slug, locale
GET/api/v1/projects/{slug}/available-unitsObter disponibilidade atual de unidades, precos, piso/quartos e links de plantas quando houver dados de origem.slug, locale
GET/api/v1/locationsListar regioes e municipios disponiveis, com slugs e URLs /cities/.limit
GET/api/v1/facetsListar filtros disponiveis, comodidades, tipologias, anos de conclusao e intervalos numericos.-
GET/api/v1/marketConsultar analitica de preco pedido de venda €/m² por todos os niveis geo: pais, regioes, distritos, municipios e localidades. Inclui historico mensal ate 10 anos, crescimento 12/24 meses, CAGR 5 anos e previsao de preco 12/24 meses.query, location, id, level, months, limit
GET/api/v1/openapi.jsonBaixar 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, get_market_price_analytics