Sava propose une API en lecture seule et un endpoint MCP pour les produits, chatbots et outils de recherche ayant besoin d'un accès structuré aux programmes résidentiels neufs au Portugal.

Le jeu de données comprend les noms des programmes, emplacements, coordonnées, typologies, équipements comme salle de sport, piscine, stationnement, spa ou sauna, fourchettes de prix et de surfaces, année de livraison, promoteur lorsqu'il est connu, images, étages, nombre total de logements, temps de trajet estimés vers la plage, l'aéroport et les écoles internationales, services accessibles en 15 minutes à pied, disponibilités actuelles, photos, images officielles et liens vers les plans lorsque les sources les fournissent.

REST API

Utilisez de simples endpoints HTTP pour rechercher des programmes, ouvrir leur fiche par slug, lister les communes, obtenir les disponibilités et consulter la spécification 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=fr
Exemple de réponse 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=fr
Endpoint des disponibilités
https://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=fr

MCP

Utilisez JSON-RPC sur /api/mcp/ pour proposer les mêmes opérations aux assistants et agents compatibles avec les outils.

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 média
https://sava.pt/api/v1/projects/1965-cidade-jardim/media?locale=fr
OpenAPI
https://sava.pt/api/v1/openapi.json
Endpoints
MéthodeCheminFonctionParamètres
GET/api/v1/projectsRecherchez des programmes par filtres, notamment region_group, équipements, services accessibles en 15 minutes à pied et disponibilité. La réponse comprend les coordonnées, l'image, les étages, le nombre total de logements, les temps de trajet, les équipements, walking_access_15_summary et un récapitulatif des disponibilités lorsque les logements actuels sont connus.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}Obtenez la fiche complète du programme, y compris available_units lorsqu'elles sont connues.slug, locale
GET/api/v1/projects/{slug}/mediaObtenez les photos, images et liens vers les plans lorsque les sources les fournissent.slug, locale
GET/api/v1/projects/{slug}/available-unitsObtenez les disponibilités actuelles, les prix, les données sur les étages et chambres et les liens vers les plans lorsqu'ils sont disponibles.slug, locale
GET/api/v1/locationsListez les régions et communes disponibles, avec leurs slugs et URL /cities/.limit
GET/api/v1/facetsListez les filtres, équipements, typologies, années de livraison et plages numériques disponibles.-
GET/api/v1/openapi.jsonObtenez la spécification OpenAPI.-
POST/api/mcp/Appelez les outils 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