Sari la conținut
Autentificare

Un API cu datele clădirilor din România.

O fișă pentru fiecare clădire din orice zonă a României, prin REST, cu fiecare estimare marcată ca estimare.

O clădire. Exemplul de răspuns documentat al endpointului de clădire.

Cheia API o creezi în aplicație, la Setări → Chei API. Fiecare cheie poate face 60 de cereri pe minut, iar un spațiu de lucru 5.000 pe zi.

Cerere
curl "https://api.baseray.ai/v1/buildings/c9eefd1b-8c8d-48fe-8b72-e015374d7720" \
  -H "Authorization: Bearer $BASERAY_API_KEY"
Răspuns
{
  "data": {
    "building_id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "address": "Bulevardul 15 Noiembrie 78",
    "nearest_road": null,
    "address_evidence": "address_record",
    "address_corroboration": "single_source",
    "postal_code": null,
    "locality": "Brașov",
    "country": "RO",
    "latitude": 45.64988,
    "longitude": 25.61044,
    "category": "commercial",
    "category_evidence": "confirmed",
    "building_type": "retail",
    "roof_shape": "flat",
    "footprint_area_m2": 31252,
    "height": {
      "metres": 18,
      "basis": "estimated"
    },
    "volume_m3": 562531,
    "volume_basis": "estimated",
    "floor_area": {
      "square_metres": 500032,
      "basis": "estimated",
      "scope": "gross_above_ground"
    },
    "floors": 16,
    "floors_including_underground": null,
    "construction_year": null,
    "completed_by_year": null,
    "dwellings": null,
    "existing_solar_panels": {
      "status": "none_seen",
      "photo_date": "2022-09-08",
      "confidence": 0.988,
      "analysed_on": null,
      "photo_resolution_cm": null
    },
    "solar_presence": "none_seen",
    "registered_solar": null,
    "solar_potential": null,
    "registered_business_count": 0,
    "registered_business_employees": null,
    "registered_business_turnover": null,
    "flood_zone": null,
    "flood_zone_mapped": false,
    "flood_zone_source": null,
    "seismic_design_acceleration_g": null,
    "seismic_risk_class": null,
    "seismic_risk_assessment_year": null,
    "owner_type": null,
    "app_url": "https://app.baseray.tech/?building=c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "entrances": null,
    "stated_facts": [],
    "is_current": true,
    "replaced_by_building_id": null,
    "outline_reference": null,
    "parts": [],
    "eave_height_m": null,
    "has_3d_model": null,
    "addresses": {
      "confirmation": "confirmed",
      "addresses": [
        {
          "line": "Strada Memorandumului 28, bl. A, sc. 1",
          "postal_code": "400114",
          "locality": "Cluj-Napoca",
          "entrance": "1",
          "dwellings_at_entrance": 24,
          "relation": "shown"
        }
      ]
    },
    "units": {
      "listed": 118,
      "listed_dwellings": 96,
      "stated": 118,
      "stated_dwellings": 96,
      "list_is_complete": true,
      "by_floor": [
        {
          "floor_kind": "ground",
          "floor_number": null,
          "units": 22,
          "dwellings": 0
        },
        {
          "floor_kind": "upper",
          "floor_number": 1,
          "units": 24,
          "dwellings": 24
        }
      ],
      "by_kind": [
        {
          "kind": "dwelling",
          "units": 96
        },
        {
          "kind": "commercial",
          "units": 4
        },
        {
          "kind": "storage",
          "units": 18
        }
      ],
      "entrances": [
        "A",
        "B"
      ],
      "entrance_dwellings": []
    },
    "record_sheet": {
      "exists": true,
      "validated": true,
      "cadastral_number": "262812-C1",
      "property_number": null,
      "land_book_number": null,
      "land_book_number_as_filed": "1997/N",
      "read_on": "2026-10-06",
      "sections": [
        {
          "title": "Performance",
          "rows": [
            {
              "label": "Heated floor area",
              "value": 2410.5,
              "unit": "m2"
            }
          ]
        }
      ]
    },
    "roof_analysis": null,
    "climate": {
      "periods": [
        {
          "period": "recent_average",
          "from": "2016",
          "to": "2025",
          "data_through": "2025-12-31",
          "coldest_day_c": -14.2,
          "hottest_day_c": 36.8,
          "frost_days": 92.4,
          "hot_days": 31.5,
          "precipitation_mm": 612.3,
          "wet_days": 104.2,
          "wettest_day_mm": 48.6
        }
      ],
      "heating_degree_days": [
        {
          "period": "standard_normal",
          "from": "1991",
          "to": "2020",
          "degree_days": 3202
        }
      ],
      "temperature_trend_c_per_decade": 0.48
    },
    "energy_networks": [
      {
        "network": "natural_gas",
        "level": "street",
        "present": true,
        "year": 2024
      }
    ],
    "heating_estimate": {
      "useful_heat_kwh_per_year": 182000,
      "useful_heat_low_kwh_per_year": null,
      "useful_heat_high_kwh_per_year": null,
      "useful_heat_kwh_per_m2_per_year": 75.5,
      "heated_floor_area_m2": 2410.5,
      "heated_floor_area_basis": "register_heated_area",
      "useful_heat_kwh_per_dwelling_per_year": 7583,
      "dwelling_count": 24,
      "delivered_energy_kwh_per_year": 214000,
      "expected_energy_kwh_per_year": 196000,
      "peak_heat_load_kw": 96.4,
      "peak_heat_load_basis": "screening_estimate",
      "design_outdoor_temperature_c": -15,
      "hot_water_heat_kwh_per_year": 41000,
      "hot_water_persons": 52.8,
      "hot_water_occupancy_basis": "counted_dwellings",
      "construction_period_is_on_record": true,
      "era_scenarios": [],
      "neighbours_are_measured": true,
      "neighbour_wall_share": 0.18,
      "heat_pump_scenarios": [
        {
          "seasonal_performance_factor": 3,
          "electricity_kwh_per_year": 60667
        }
      ]
    }
  }
}

Ce întoarce API-ul. Fiecare valoare e un fapt sau null, iar estimările spun că sunt estimări.

Clădirile dintr-o zonă

Adresa, unde există o înregistrare, categoria, amprenta, înălțimea și volumul, etajele, locuințele și scările, unde se cunosc.

Măsurat sau estimat

Fiecare înălțime și fiecare volum spune cum a fost obținut.

Panourile solare existente

Detectate, nevăzute sau neclar, cu data fotografiei, și potențialul solar al acoperișului, unde a fost modelat.

Firmele cu sediul la adresă

Firmele al căror sediu social este exact adresa oficială a clădirii, cu CUI-ul lor. Niciodată proprietate sau ocupare.

De la cheie la primele clădiri. Trei pași.

  1. 01

    Creează o cheie

    În aplicație, la Setări → Chei API.

  2. 02

    Trimite o cerere

    GET /v1/buildings cu o zonă, o ordonare și o limită, sau o singură clădire după id. Totul e în documentația API.

  3. 03

    Sau întreabă într-un chat

    Prin serverul MCP întrebi despre clădiri în ChatGPT sau Claude.

Întrebări despre API. Ce conține fișa și ce nu conține încă.

Acoperă API-ul toată România?

Da, fiecare județ. Fiecare clădire are o fișă; valorile care nu se cunosc sunt null, nu ghicite.

Întoarce anul construcției sau numărul cadastral?

Încă nu; aplicația le arată unde se cunosc. Pentru uz juridic sau notarial, actul oficial e extrasul de carte funciară din ePay ANCPI.

Pot folosi API-ul din ChatGPT sau Claude?

Da, prin serverul MCP baseray. Documentația MCP are pașii de configurare pentru fiecare client.

Starter: 50 de rapoarte de clădiri pe lună pentru 39 EUR. 0,78 EUR pe clădire.

Alege Starter

Un credit deschide o clădire în aplicație, cu raportul ei PDF. Plată lunară, anulezi oricând.