Publiczne API Mapy Oświatowej

curl "https://api.mapaoswiatowa.pl/api/institutions?city=Czy%C5%BCowice&type=PRIMARY_SCHOOL"

curl "https://api.mapaoswiatowa.pl/api/locations/search?q=Czy%C5%BCowice"
curl "https://api.mapaoswiatowa.pl/api/institutions/nearby?lat=49.9828&lng=18.4088&radius=10&type=NURSERY"

curl "https://api.mapaoswiatowa.pl/api/institutions?voivodeship=slaskie&subtype=TECHNICAL_SECONDARY&sortBy=views&limit=20"

curl "https://api.mapaoswiatowa.pl/api/institutions?voivodeship=mazowieckie&powiat=piaseczynski&type=PRESCHOOL&hasFreePlaces=true&limit=20"

curl "https://api.mapaoswiatowa.pl/api/institutions?city=Warszawa&type=PRIMARY_SCHOOL&exam=E8&examYear=2026&examSubject=matematyka&limit=10"

curl "https://api.mapaoswiatowa.pl/api/cities/warszawa"

Wyszukiwanie i geokodowanie

• GET/api/locations/search?q={fraza}

  Jedyny sposób zamiany nazwy miejscowości na współrzędne. Wynik typu city niesie id — to cityId, którym filtruje się placówki jednoznacznie.

• GET/api/locations/reverse?lat={lat}&lng={lng}

  Najbliższa miejscowość dla podanych współrzędnych.

Placówki

• GET/api/institutions

  Paginowana lista z ponad 30 filtrami. Bez danych kontaktowych i bez opisu placówki. Odpowiedź niesie institutions[] i pagination.

• GET/api/institutions/nearby?lat={lat}&lng={lng}&radius={km}

  Placówki w promieniu, posortowane po odległości (pole distance w km). Wpisy promowane wracają osobno, w polu promoted.

• GET/api/institutions/{id}

  Pełny profil: ponad 50 pól, zdjęcia z atrybucją, statystyki SIO, wyniki egzaminów, dane kontaktowe. Jako {id} zadziała id, slug, numer RSPO (z ?by=rspo) albo numer rejestru żłobków.

• GET/api/institutions/popular

  Dzienna próbka najczęściej oglądanych placówek z opisem.

Miejscowości i podziały administracyjne

• GET/api/cities?voivodeship={slug}

  Miejscowości z liczbą placówek, malejąco.

• GET/api/cities/{slug}

  Szczegóły miejscowości: rodzaj TERYT, środek z PRNG, ludność NSP 2021, szeregi oświatowe GUS i agregaty SIO.

• GET/api/divisions?level=powiat|gmina

  Wszystkie powiaty albo wszystkie gminy naraz, z najnowszym rocznikiem GUS BDL i SIO dla każdej jednostki osobno.

• GET/api/divisions/{woj}

  Powiaty województwa z kodami TERC i liczbami placówek.

• GET/api/divisions/{woj}/{powiat}

  Szczegóły powiatu. Miasto na prawach powiatu zwraca obiekt redirect ze slugiem swojej strony miejskiej.

• GET/api/divisions/{woj}/{powiat}/{gmina}

  Szczegóły gminy razem ze wskaźnikami GUS BDL. Gmina miejska zwraca obiekt redirect.

• GET/api/districts/{city}/{district}

  Dzielnica jednego z pięciu miast, które je mają — z seriami GUS BDL dla dzielnic Warszawy.

• GET/api/voivodeships/{slug}

  Statystyki województwa, 10 największych miast i oficjalne szeregi GUS BDL od 2008 roku.

Statystyki

• GET/api/statistics

  Agregaty krajowe wg typu, podtypu i województwa oraz krajowe sumy SIO za najnowszy rok szkolny.

• GET/api/statistics/fees?type=NURSERY|PRESCHOOL

  Statystyki opłat. Przy zbyt małej próbie zakres rozszerza się z miasta na województwo, a potem na kraj — pole scope mówi, czego wynik faktycznie dotyczy.

• GET/api/statistics/nursery-fees

  Rozkład opłat za pobyt w żłobkach na tle ustawowego progu świadczenia Aktywnie w żłobku.

• GET/api/statistics/nursery-places

  Miejsca, dzieci i wolne miejsca w żłobkach: kraj, sektory, województwa i dzielnice pięciu miast — w jednej odpowiedzi.

• GET/api/statistics/vocational-trends

  Krajowe trendy naboru do zawodów szkolnictwa branżowego wg danych SIO.

• GET/api/statistics/demographic-forecast

  Prognoza ludności GUS do 2060 roku w edukacyjnych grupach wieku, dla kraju i 16 województw.

• GET/api/statistics/specialists

  Zatrudnienie logopedów, psychologów i pedagogów oraz nauczane języki — z otwartego eksportu RSPO.

• GET/api/statistics/exams?exam={E8|EM2023}

  Średni wynik z każdego przedmiotu i liczba zdających w 16 województwach, rok po roku — Mapa wyników egzaminów (CIE, MEN).

Patroni i zawody

• GET/api/patrons/search?q={fraza}

  Patroni szkół z liczbą placówek.

• GET/api/patrons/top

  Ranking patronów wraz ze slugiem strony patrona.

• GET/api/patrons/stats

  Podział patronów na kategorie i płeć — klasyfikacja automatyczna, z datą w polu classifiedAt.

• GET/api/patrons/{slug}

  Patron po slugu. Patron z mniej niż 10 placówkami nie ma własnej strony i zwraca 404.

• GET/api/vocational/professions

  Zawody nauczane w technikach i szkołach branżowych — słownik do podpowiedzi i filtrowania.

• GET/api/vocational/professions/all

  Wszystkie zawody, w których uczy dziś choć jedna szkoła, z liczbą szkół i adresem strony zawodu.

• GET/api/vocational/professions/{slug}

  Zawód po slugu strony, z liczbą szkół, nazwą branży i podstawą programową.

Źródła danych

• GET/api/data-sources

  Skąd pochodzi każda liczba, na jakiej licencji i kiedy trafiła do bazy. Uwaga na dwie różne daty: refreshedAt to moment naszego importu, sourceVintage — rocznik samego źródła. Dla spisu powszechnego dzieli je kilka lat.

Status

• GET/health

  Stan usługi i jej bazy danych. Ten adres wskazuje relacja status w katalogu API.