Sava offre un'API di sola lettura e un endpoint MCP per prodotti, chatbot e strumenti di ricerca che richiedono un accesso strutturato ai nuovi progetti residenziali in Portogallo.

Il dataset include nomi dei progetti, località, coordinate, tipologie, servizi come palestra, piscina, parcheggio, spa o sauna, fasce di prezzo e superficie, anno di consegna, promotore quando noto, immagini, piani, numero totale di unità, tempi stimati per spiaggia, aeroporto e scuole internazionali, servizi raggiungibili in 15 minuti a piedi, disponibilità aggiornata, foto, immagini ufficiali e link alle planimetrie quando presenti nelle fonti.

REST API

Usa semplici endpoint HTTP per cercare progetti, aprire i dettagli tramite slug, elencare i comuni, ottenere le disponibilità e consultare la specifica 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=it
Esempio di risposta 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=it
Endpoint disponibilità
https://sava.pt/api/v1/projects/1965-cidade-jardim/available-units?locale=it

MCP

Usa JSON-RPC su /api/mcp/ per rendere disponibili le stesse operazioni ad assistenti e agenti compatibili con strumenti.

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 media
https://sava.pt/api/v1/projects/1965-cidade-jardim/media?locale=it
OpenAPI
https://sava.pt/api/v1/openapi.json
Endpoint
MetodoPercorsoFunzioneParametri
GET/api/v1/projectsCerca progetti tramite filtri, inclusi region_group, servizi, infrastrutture raggiungibili in 15 minuti a piedi e disponibilità. La risposta include coordinate, immagine, piani, unità totali, tempi di percorrenza, servizi, walking_access_15_summary e un riepilogo della disponibilità quando le unità attuali sono note.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}Ottieni tutti i dettagli del progetto, incluse le available_units quando note.slug, locale
GET/api/v1/projects/{slug}/mediaOttieni foto, immagini e link alle planimetrie quando disponibili nelle fonti.slug, locale
GET/api/v1/projects/{slug}/available-unitsOttieni disponibilità aggiornata, prezzi, dati su piani e camere e link alle planimetrie quando disponibili.slug, locale
GET/api/v1/locationsElenca regioni e comuni disponibili, con slug e URL /cities/.limit
GET/api/v1/facetsElenca filtri, servizi, tipologie, anni di consegna e intervalli numerici disponibili.-
GET/api/v1/openapi.jsonOttieni la specifica OpenAPI.-
POST/api/mcp/Richiama gli strumenti MCP tramite 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