EstateX Valuation API

Jedno API pro odhad ceny nemovitosti

Primární produkční endpoint je Council: bere adresu i URL inzerátu, vrací finální cenu, produkční odhad, Direct CMA kontrolu, divergenci, interval, jistotu a rozhodovací verdikt.

GET /v1/cenova/council POST /v1/cenova/council GET /v1/cenova/report POST JSON OpenAPI Rate-limit aktivní

GET

Nejjednodušší integrace. Parametr input může být přesná adresa nebo URL inzerátu.

curl "https://shadow.czechai.io/v1/cenova/council?input=N%C3%A1rodn%C3%AD%2016%2C%20Praha%201&type=byt&area=65&dispozice=2"

POST

Stabilní varianta pro aplikace a backend integrace.

curl -X POST "https://shadow.czechai.io/v1/cenova/council" \
  -H "content-type: application/json" \
  -d "{\"input\":\"Národní 16, Praha 1\",\"type\":\"byt\",\"area\":65,\"dispozice\":2}"

Arbiter

Nižší produkční vrstva bez Direct CMA kontroly. Pro nejlepší výsledek používej Council.

curl -X POST "https://shadow.czechai.io/v1/cenova/adjudicate" \
  -H "content-type: application/json" \
  -d "{\"input\":\"Národní 16, Praha 1\",\"type\":\"byt\",\"area\":65,\"rent\":33000}"

Report

Tisknutelný HTML report pro klienta, uložitelný jako PDF přes prohlížeč.

curl "https://shadow.czechai.io/v1/cenova/report?input=N%C3%A1rodn%C3%AD%2016%2C%20Praha%201&type=byt&area=65"

Výstup

{
  "ok": true,
  "mode": "address",
  "model": "EstateX Valuation Council v1",
  "council": {
    "decision": "CONFIRM",
    "decisionCs": "POTVRDIT S VÝHRADOU",
    "finalPrice": 12220000,
    "divergencePct": 15.33
  },
  "production": {
    "price": 12220000,
    "interval": { "low": 11091000, "high": 13349000 },
    "confidence": { "score": 94, "label": "vysoká" }
  },
  "directCma": {
    "price": 10347000,
    "confidence": { "comparables": 26 }
  }
}

Výstup arbitra

{
  "ok": true,
  "decision": "APPROVE",
  "decisionCs": "ODSOUHLASIT",
  "risk": "low",
  "price": 12220000,
  "interval": { "low": 11091000, "high": 13349000 },
  "confidence": { "score": 94, "label": "vysoká" },
  "reasons": ["Silný prostorový vzorek: 30 sousedských bodů."],
  "warnings": ["Investiční cash-on-cash je výrazně záporný: -9.14 %."]
}

OpenAPI

Strojově čitelný kontrakt pro nástroje, klienty a dokumentaci.

/v1/cenova/openapi.json

Widget

Veřejná prémiová UI varianta pro web.

<div data-cenova-widget></div>
<script src="https://shadow.czechai.io/widget/cenova-widget.js"></script>