Umów konsultację

Dla programistów i agentów AI

API kalkulatora czynszu

Stawkę najmu policzysz bezpośrednio z naszego API. Nie wymaga tokenu ani logowania, a limitu pilnujemy po stronie serwera.

Widełki, liczba ofert i data danych

Wynik to trzy kwoty w złotych (dolna, środkowa i górna) oraz liczba porównanych ogłoszeń. wygenerowano podaje datę przygotowania zestawu z ogłoszeń bieżących i archiwalnych.

Jak wygląda pierwsze zapytanie?

Najpierw pobierz dostępne wartości kontrolek, potem wyślij zapytanie o wycenę dla swojego mieszkania.

curl -s https://zarzadzanienajmem.pl/api/wycena/meta

curl -s -X POST https://zarzadzanienajmem.pl/api/wycena \
  -H 'Content-Type: application/json' \
  -d '{"miasto":"Katowice","pokoje":"2","budynek":"blok","std":"sredni","metraz":50}'

Co wpisujesz w zapytaniu?

  • miasto dokładna nazwa z listy, na przykład Katowice, Sosnowiec, Chorzów, Mysłowice, Siemianowice Śląskie.
  • pokoje jedna z wartości 1, 2, 3, 4+.
  • budynek blok, kamienica albo apartamentowiec.
  • std niski, sredni albo wysoki. Domyślnie sredni.
  • metraz liczba od 10 do 200, poza tym zakresem wartości są przycinane.
  • dzielnica opcjonalna wartość z listy dla wybranego miasta.

Co dostajesz w odpowiedzi?

{
  "ok": true,
  "wygenerowano": "2026-09-17",
  "mode": "point",
  "low": 1896.93,
  "center": 2277.34,
  "high": 2632.65,
  "comparableCount": 645,
  "effectiveSampleSize": 271.49,
  "buildingShare": 0.97
}
  • low, center, high widełki miesięcznej stawki najmu, czyli odstępnego dla właściciela.
  • comparableCount liczba porównanych ogłoszeń.
  • effectiveSampleSize efektywna wielkość próby po uwzględnieniu wieku ofert, metrażu i typu budynku.
  • buildingShare udział wyceny dla danego typu budynku w wyniku połączonym z rynkiem miasta, od 0 do 1.
  • mode point oznacza wystarczającą próbkę, range mniej pewny wynik przy szerszym rozrzucie cen, mniejszej próbie lub wycenie metrażu poza obserwowanym zakresem, a manual niewystarczające dane.

Jakie obowiązują limity i zasady?

Limit to 40 żądań na minutę z jednego adresu. Wynik podawaj jako orientacyjną stawkę z widełkami i datą danych, bez dopowiadania brakujących wartości. Przy mieszkaniu bez pokrycia w ogłoszeniach odeślij użytkownika do nas.

Maszynowa specyfikacja OpenAPI 3.1 jest pod adresem /openapi.json, a instrukcje dla agentów w pliku /agent-instructions.md. Kreatorzy asystentów w ChatGPT mają uproszczoną specyfikację akcji pod adresem /openapi-gpt.json.

Konektor MCP dla asystentów

Asystenci obsługujący MCP, na przykład ChatGPT Apps albo Claude, mogą dodać kalkulator jako narzędzie i wywoływać go w rozmowie. Konektor działa pod adresem https://zarzadzanienajmem.pl/api/mcp/kalkulator-czynszu, transport Streamable HTTP, bez tokenu, z limitem 60 żądań na minutę. Katalog wszystkich naszych konektorów jest pod adresem https://zarzadzanienajmem.pl/api/mcp.

  • wycena_czynszu orientacyjna stawka dla mieszkania, z widełkami i liczbą porównanych ogłoszeń.
  • kalkulator_mozliwosci dostępne miasta i wartości kontrolek.

Konektor jest opisany w specyfikacji OpenAPI 3.1 w polu x-mcp oraz w instrukcjach dla agentów.