---
title: "API kalkulatora czynszu. Specyfikacja i przykład"
description: "Publiczne API wyceny czynszu najmu dla Katowic i okolic. Bez tokenu, limit 40 żądań na minutę. Pola, przykłady i specyfikacja OpenAPI."
image: "https://zarzadzanienajmem.pl/og/wycena-czynszu.jpg?v=20260823"
canonical: "https://zarzadzanienajmem.pl/kalkulator-czynszu/api/"
---

[Strona główna](/)›[Kalkulator czynszu](/kalkulator-czynszu/)›API

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](/openapi.json), a instrukcje dla agentów w pliku [/agent-instructions.md](/agent-instructions.md). Kreatorzy asystentów w ChatGPT mają uproszczoną specyfikację akcji pod adresem [/openapi-gpt.json](/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.

Potrzebujesz wyceny dla konkretnego mieszkania?

Zrobimy ją na danych z rynku.Rozmowa nic nie kosztuje i do niczego nie zobowiązuje.

[Umów konsultację](/kontakt/) [Wróć do kalkulatora](/kalkulator-czynszu/)

Wolisz od razu porozmawiać? [+48 530 630 090](tel:+48530630090)

## Dane strukturalne

```json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "@id": "https://zarzadzanienajmem.pl/kalkulator-czynszu/api/#breadcrumb",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Strona główna",
      "item": "https://zarzadzanienajmem.pl/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Kalkulator czynszu",
      "item": "https://zarzadzanienajmem.pl/kalkulator-czynszu/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "API",
      "item": "https://zarzadzanienajmem.pl/kalkulator-czynszu/api/"
    }
  ]
}
```