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, tipologias, intervalos de preco e area, ano de conclusao, promotor quando conhecido e tempos estimados ate a praia e ao aeroporto.
REST API
Use endpoints HTTP simples para pesquisar projetos, abrir detalhes por slug, listar municipios e baixar a especificacao OpenAPI.
Endpoint
https://sava.pt/api/v1/projects?municipality=Lisboa&typology=T2&max_price=700000&limit=3&locale=pt
Endpoint
https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=pt
MCP
Use JSON-RPC em /api/mcp/ para expor as mesmas operacoes a assistentes e agentes compativeis com ferramentas.
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":{}}'
OpenAPI
https://sava.pt/api/v1/openapi.json
| Metodo | Path | Uso | Parametros |
|---|---|---|---|
GET | /api/v1/projects | Pesquisar projetos por filtros. | municipality, locality, typology, property_type, min_price, max_price, min_area, max_area, completion_year, max_beach_drive_minutes, max_airport_drive_minutes, locale, limit |
GET | /api/v1/projects/{slug} | Obter detalhes completos de um projeto. | slug, locale |
GET | /api/v1/locations | Listar municipios disponiveis. | limit |
GET | /api/v1/openapi.json | Baixar a especificacao OpenAPI. | - |
POST | /api/mcp/ | Chamar ferramentas MCP via JSON-RPC. | tools/list, tools/call |