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.