Sari la conținut
Autentificare Creează cont

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",
    "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,
    "existing_solar_panels": {
      "status": "none_seen",
      "photo_date": "2022-09-08",
      "confidence": 0.988
    },
    "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,
    "seismic_design_acceleration_g": null,
    "seismic_risk_class": null,
    "seismic_risk_assessment_year": null,
    "app_url": "https://app.baseray.ai/?building=c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "dwellings": null,
    "entrances": null,
    "stated_facts": [],
    "is_current": true,
    "replaced_by_building_id": null
  }
}

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.

Adu baseray în zona ta. Spune-ne regiunile tale și ce vinzi. Încărcăm datele și construim cu tine primele segmente.

Fără card. După aceea, planuri de la 39 EUR pe lună.