Sava предоставляет read-only API и MCP endpoint для продуктов, чатботов и исследовательских инструментов, которым нужны структурированные данные о жилых новостройках Португалии.
В данных есть названия проектов, локации, типологии, диапазоны цен и площадей, год завершения, застройщик при наличии, а также примерное время до пляжа и аэропорта.
REST API
Используйте простые HTTP endpoints для поиска проектов, деталей по slug, списка муниципалитетов и OpenAPI-спецификации.
Endpoint
https://sava.pt/api/v1/projects?municipality=Lisboa&typology=T2&max_price=700000&limit=3&locale=ru
Endpoint
https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=ru
MCP
Используйте JSON-RPC на /api/mcp/, чтобы дать ассистентам и агентам те же операции в формате инструментов.
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
| Метод | Path | Назначение | Параметры |
|---|---|---|---|
GET | /api/v1/projects | Поиск проектов по фильтрам. | 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} | Полные детали проекта. | slug, locale |
GET | /api/v1/locations | Список доступных муниципалитетов. | limit |
GET | /api/v1/openapi.json | OpenAPI-спецификация. | - |
POST | /api/mcp/ | Вызов MCP-инструментов через JSON-RPC. | tools/list, tools/call |