DKOR.pl / DKOR Index / Dane / API
DKOR PUBLIC API • V1

Publiczne API danych kosztów remontu

API jest tylko do odczytu i udostępnia wyłącznie publiczne dane kosztowe DKOR: indeks miast, lokalne stawki usług, trendy cen usług oraz historię miesięcznych snapshotów.

Base URL https://dkor.pl/api/public/v1
ENDPOINTY

DKOR Public API v1

GET
/index/cities

Lista miast z DKOR Index, poziomem kosztów i modelem remontu 60 m².

Otwórz JSON
GET
/index/cities/:citySlug

Szczegóły miasta, lokalne stawki wszystkich aktywnych usług i linki DKOR.

Przykład: /index/cities/koszalin
Przykład
GET
/services

Aktywne usługi i bazowe widełki cenowe DKOR.

Otwórz JSON
GET
/index/services

Aktywne usługi, aktualne widełki oraz dostępne zmiany miesiąc do miesiąca i rok do roku.

Otwórz JSON
GET
/index/services/:serviceSlug/history

Miesięczne snapshoty stawek wybranej usługi.

Przykład: /index/services/malowanie-scian/history
Przykład
GET
/index/history

Miesięczne snapshoty modelu referencyjnego 60 m².

Otwórz JSON
GET
/index/history/:citySlug

Historia DKOR Index i modelowego kosztu dla wybranego miasta.

Przykład: /index/history/koszalin
Przykład
FORMAT

Stabilna wersja v1

Każda odpowiedź zawiera sekcję meta z wersją schematu, źródłem, czasem wygenerowania i odnośnikiem do metodologii.

Endpointy JSON mają nagłówek X-Robots-Tag: noindex, nofollow, dlatego do indeksowania przeznaczona jest dokumentacja, a nie surowe odpowiedzi API.

API zwraca nagłówek CORS Access-Control-Allow-Origin: *, ponieważ zawiera wyłącznie publiczne dane kosztowe.

PRZYKŁADOWA ODPOWIEDŹ

Miasto

{
  "meta": {
    "schema_version": "1.0",
    "source": "DKOR.pl"
  },
  "data": {
    "slug": "koszalin",
    "name": "Koszalin",
    "dkor_index": 94,
    "model_60m2": {
      "avg_pln": 12345
    }
  }
}

Wartości powyżej są przykładem struktury. Aktualne liczby pobieraj z endpointu API.