Mapa Oświatowa — publiczne API

Dane o ponad 59 000 polskich placówek oświatowych: żłobkach, przedszkolach, szkołach i uczelniach.

Gotowe wywołania

Szkoły podstawowe w miejscowości
Nazwa miejscowości zakodowana, bo ma polskie znaki.
https://api.mapaoswiatowa.pl/api/institutions?city=Czy%C5%BCowice&type=PRIMARY_SCHOOL
Żłobki w promieniu 10 km
Dwa kroki: nazwa miejscowości nie jest współrzędnymi, a `/nearby` przyjmuje tylko te drugie.
https://api.mapaoswiatowa.pl/api/locations/search?q=Czy%C5%BCowicehttps://api.mapaoswiatowa.pl/api/institutions/nearby?lat=49.9828&lng=18.4088&radius=10&type=NURSERY
Technika w województwie, wg popularności
Filtry łączą się jako kolejne parametry; `sortBy` ma pięć wartości.
https://api.mapaoswiatowa.pl/api/institutions?voivodeship=slaskie&subtype=TECHNICAL_SECONDARY&sortBy=views&limit=20
Przedszkola z wolnymi miejscami w powiecie
Slug powiatu jest unikalny dopiero w województwie, więc oba parametry idą razem.
https://api.mapaoswiatowa.pl/api/institutions?voivodeship=mazowieckie&powiat=piaseczynski&type=PRESCHOOL&hasFreePlaces=true&limit=20
Wynik matematyki na egzaminie ósmoklasisty 2026
Jedno zapytanie zamiast detalu per szkoła; szkoła bez podejścia ma `examYears: null` i zostaje w wyniku.
https://api.mapaoswiatowa.pl/api/institutions?city=Warszawa&type=PRIMARY_SCHOOL&exam=E8&examYear=2026&examSubject=matematyka&limit=10
Miejscowość ze statystykami
Ludność, rozbicie na typy, odmiana nazwy i środek miejscowości.
https://api.mapaoswiatowa.pl/api/cities/warszawa

Endpointy

Placówki

GET /api/institutionsPaginowana lista placówek
GET /api/institutions/nearbyPlacówki w promieniu od punktu
GET /api/institutions/{id}Pełny profil placówki
GET /api/institutions/popularNajczęściej oglądane placówki

Wyszukiwanie

GET /api/locations/searchWyszukiwarka miejscowości, dzielnic, placówek i kodów pocztowych
GET /api/locations/reverseNajbliższa miejscowość dla współrzędnych

Miejscowości

GET /api/citiesMiejscowości z liczbą placówek
GET /api/cities/{slug}Szczegóły miejscowości

Podziały administracyjne

GET /api/divisionsWszystkie powiaty albo wszystkie gminy
GET /api/divisions/{woj}Powiaty województwa
GET /api/divisions/{woj}/{powiat}Szczegóły powiatu
GET /api/divisions/{woj}/{powiat}/{gmina}Szczegóły gminy
GET /api/districts/{city}/{district}Szczegóły dzielnicy
GET /api/voivodeships/{slug}Statystyki województwa

Statystyki

GET /api/statisticsAgregaty ogólnokrajowe
GET /api/statistics/feesStatystyki opłat w żłobkach i przedszkolach
GET /api/statistics/nursery-feesKrajowy rozkład opłat w żłobkach
GET /api/statistics/nursery-placesGdzie są miejsca w żłobkach
GET /api/statistics/vocational-trendsKrajowe trendy zawodów szkolnictwa branżowego
GET /api/statistics/demographic-forecastPrognoza demograficzna GUS w grupach wieku edukacyjnego
GET /api/statistics/specialistsZatrudnienie specjalistów i nauczane języki
GET /api/statistics/examsWyniki egzaminu ósmoklasisty i matury według województw

Patroni

GET /api/patrons/searchWyszukiwarka patronów
GET /api/patrons/topNajpopularniejsi patroni
GET /api/patrons/statsStatystyki patronów
GET /api/patrons/{slug}Patron po slugu

Kształcenie zawodowe

GET /api/vocational/professionsZawody nauczane w technikach i szkołach branżowych
GET /api/vocational/professions/allPełny katalog zawodów z liczbą szkół
GET /api/vocational/professions/{slug}Jeden zawód

Źródła danych

GET /api/data-sourcesŹródła danych i ich aktualność

Status

GET /healthStan usługi