Dla programistów

Dane RCN w Twojej aplikacji.

REST do integracji. MCP do asystenta AI. Ten sam klucz, dane i wspólny limit. 100 bezpłatnych operacji co miesiąc po rejestracji.

Utwórz konto i klucz

1. Pierwsze zapytanie

W panelu konta utwórz klucz. Zapisz go w zmiennej środowiskowej ILEMETR_API_KEY po stronie serwera.

curl 'https://ilemetr.pl/api/v1/transactions?city=Warszawa&propertyType=4&limit=5' \
  -H "Authorization: Bearer $ILEMETR_API_KEY"

Podaj city lub teryt. Opcjonalnie: street, propertyType (1–4, domyślnie 4), market (1 lub 2), minArea, maxArea, dateFrom, dateTo (YYYY-MM-DD), page (1–100), limit (1–100). Nazwa miasta i ulicy musi być pełna; wielkość liter nie ma znaczenia. Odpowiedź: results, hasMore, page, usage. Pole price jest ceną całej transakcji.

2. Raport porównawczy

curl https://ilemetr.pl/api/v1/reports \
  -H "Authorization: Bearer $ILEMETR_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"city":"Warszawa","street":"Solec","area":55,"market":2}'

Odpowiedź data zawiera ID, zapisany zestaw porównań, metodę, źródła i ograniczenia. Pole summary.status ma wartość insufficient, gdy próba jest zbyt mała. Nie traktuj tego jako błędu ani nie dopowiadaj ceny.

Pobierz zapis: GET /api/v1/reports/ID. Sprawdź limit: GET /api/v1/usage. Obie operacje są bezpłatne.

3. Połącz MCP

Transport: Streamable HTTP. W kliencie obsługującym zdalny MCP z nagłówkiem Authorization dodaj:

{
  "mcpServers": {
    "ilemetr": {
      "url": "https://ilemetr.pl/api/mcp",
      "headers": {
        "Authorization": "Bearer TWÓJ_KLUCZ_ILEMETR"
      }
    }
  }
}

Format konfiguracji zależy od klienta. Ten serwer używa klucza Bearer; nie udostępnia logowania OAuth. Klient wymagający wyłącznie OAuth nie połączy się bez adaptera.

search_transactions — wyszukiwanie, 1 operacja.
create_report — zapis raportu, 1 operacja.
get_report — odczyt własnego raportu, bez zużycia limitu.
get_usage — wykorzystanie i termin odnowienia, bez zużycia limitu.

Błędy i limity

400: parametry, 401: klucz, 403: niedozwolone źródło, 404: raport, 429: miesięczna kwota lub tempo, 503: chwilowa niedostępność. Błąd ma strukturę {"error":{"code":"…","message":"…"}}. Przy 429 odczytaj Retry-After; kod quota_exceeded oznacza koniec miesięcznej puli.

Nie wysyłaj klucza w adresie URL, kodzie frontendu ani publicznym repozytorium. Publiczna mapa i wyszukiwarka nie są interfejsem do masowego pobierania. Warunki osadzania i eksportu znajdziesz w regulaminie.

Dobierz plan do integracji

1. Pierwsze zapytanie

W panelu konta utwórz klucz. Zapisz go w zmiennej środowiskowej ILEMETR_API_KEY po stronie serwera.

curl 'https://ilemetr.pl/api/v1/transactions?city=Warszawa&propertyType=4&limit=5' \ -H "Authorization: Bearer $ILEMETR_API_KEY"

2. Raport porównawczy

curl https://ilemetr.pl/api/v1/reports \ -H "Authorization: Bearer $ILEMETR_API_KEY" \ -H 'Content-Type: application/json' \ -d '{"city":"Warszawa","street":"Solec","area":55,"market":2}'

Pobierz zapis: GET /api/v1/reports/ID. Sprawdź limit: GET /api/v1/usage. Obie operacje są bezpłatne.

3. Połącz MCP

Transport: Streamable HTTP. W kliencie obsługującym zdalny MCP z nagłówkiem Authorization dodaj:

{ "mcpServers": { "ilemetr": { "url": "https://ilemetr.pl/api/mcp", "headers": { "Authorization": "Bearer TWÓJ_KLUCZ_ILEMETR" } } } }

Format konfiguracji zależy od klienta. Ten serwer używa klucza Bearer; nie udostępnia logowania OAuth. Klient wymagający wyłącznie OAuth nie połączy się bez adaptera.

search_transactions — wyszukiwanie, 1 operacja.

create_report — zapis raportu, 1 operacja.

get_report — odczyt własnego raportu, bez zużycia limitu.

get_usage — wykorzystanie i termin odnowienia, bez zużycia limitu.

Błędy i limity