Sava надає API лише для читання та MCP-інтерфейс для продуктів, чатботів і дослідницьких інструментів, яким потрібен структурований доступ до даних про нові житлові проєкти в Португалії.

Набір даних містить назви проєктів, локації, координати, планування, інфраструктуру на кшталт спортзалу, басейну, паркінгу, спа чи сауни, діапазони цін і площ, рік здачі, забудовника, зображення, поверховість, загальну кількість юнітів, орієнтовний час у дорозі до пляжу, аеропорту та міжнародних шкіл, інфраструктуру в межах 15 хвилин пішки, а також актуальну наявність квартир, фотографії, офіційні зображення й посилання на плани, якщо ці дані є у джерелі.

REST API

Використовуйте прості HTTP-ендпоїнти, щоб шукати проєкти, відкривати деталі за slug, отримувати список муніципалітетів і таблиці наявності та переглядати специфікацію 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=uk
Приклад відповіді 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
      }
    }
  ]
}
Ендпоїнт
https://sava.pt/api/v1/projects/1965-cidade-jardim?locale=uk
Ендпоїнт наявності
https://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=uk

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":{}}'
Ендпоїнт медіа
https://sava.pt/api/v1/projects/1965-cidade-jardim/media?locale=uk
OpenAPI
https://sava.pt/api/v1/openapi.json
Ендпоїнтs
МетодШляхПризначенняПараметри
GET/api/v1/projectsПошук проєктів за фільтрами, зокрема region_group, інфраструктурою, об'єктами в межах 15 хвилин пішки та наявністю. Відповідь містить координати, зображення, поверховість, загальну кількість юнітів, час у дорозі, інфраструктуру, walking_access_15_summary і зведення наявності, якщо відомі актуальні юніти.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}Отримати повні дані про проєкт, зокрема available_units, якщо вони відомі.slug, locale
GET/api/v1/projects/{slug}/mediaОтримати фотографії, зображення проєкту та посилання на плани, якщо вони є у джерелі.slug, locale
GET/api/v1/projects/{slug}/available-unitsОтримати актуальну наявність юнітів, ціни, дані про поверхи й спальні та посилання на плани, якщо вони є у джерелі.slug, locale
GET/api/v1/locationsОтримати список доступних регіонів і муніципалітетів зі slug та URL розділу /cities/.limit
GET/api/v1/facetsОтримати доступні фільтри, інфраструктуру, планування, роки здачі та числові діапазони.-
GET/api/v1/openapi.jsonОтримати специфікацію OpenAPI.-
POST/api/mcp/Викликати інструменти MCP через 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