НВО и ДЗИ

Отворени данни · v1

НВО & ДЗИ API

Публично JSON API с резултати от НВО и ДЗИ (2018-2026). Без ключ и без ограничения - статични файлове, които се обновяват заедно със сайта.

Резултатите са в оригиналния вид от МОН, от 2018 г. НВО след 7 клас за 2018 г. е по 65-точкова скала (сайтът показва данните от 2019 г. насам). Изключение са годините без изпит: НВО след 4 клас не е провеждано през 2020 г., а НВО след 10 клас започва през 2021 г. В данните тези години повтарят 2019 г., съответно 2021 г., за да няма празна година в средните за 3 години - вижте noExamYears в index.json.

Base URL: https://ivandavidov.github.io/nvo/api/v1

Общи

▶ GET /index.json Списък на наличните класове с метаданни

Отговор

ПолеТипОписание
gradesarrayМасив с обекти за всеки клас
grades[].gradenumberКлас (4, 7, 10, 12)
grades[].labelstringЧетимо име
grades[].yearsRangearrayМасив с години с данни
grades[].scaleMinnumberМинимална стойност на скалата
grades[].scaleMaxnumberМаксимална стойност на скалата
grades[].dataUrlstringОтносителен път до пълните данни
grades[].noExamYearsarrayГодини без изпит: {year, copyOf} - в данните годината year повтаря резултатите от copyOf

Справочник

▶ GET /schools.json Всички училища с метаданни

Отговор

ПолеТипОписание
schoolsobjectУчилища с данни (ключ = код)
schools.*.shortNamestringКратко име
schools.*.fullNamestringПълно име на училището
schools.*.monNamestring|nullИмето точно както е в данните на МОН
schools.*.registerStatusstring|nullСтатус в регистъра на МОН: действаща, закрита, преобразувана (закрита), отписана, заличена
schools.*.officialNamestring|nullОфициалното име, изчистено (без кавички, с правилни главни букви и препинание)
schools.*.websitestring|nullУебсайт (null ако няма)
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.citystring|nullSlug на града
schools.*.gradesarrayКласове, в които има данни
▶ GET /schools-index.json Компактен индекс за търсене на училище

Отговор

ПолеТипОписание
schoolsarrayСписък училища
schools[].codestringКод на училището
schools[].shortNamestringКратко име
schools[].fullNamestringПълно име
schools[].isPrivatebooleanЧастно училище
schools[].financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools[].citystringИме на града
schools[].cityOrdernumberПодредба на града (както в сайта)
schools[].gradesarrayКласове с данни
▶ GET /schools/{code}.json Данни за училище: резултати по класове + рангове

Отговор

ПолеТипОписание
codestringКод на училището
shortNamestringКратко име
fullNamestringПълно име на училището
monNamestring|nullИмето точно както е в данните на МОН
registerStatusstring|nullСтатус в регистъра на МОН: действаща, закрита, преобразувана (закрита), отписана, заличена
officialNamestring|nullОфициалното име, изчистено (без кавички, с правилни главни букви и препинание)
websitestring|nullУебсайт (null ако няма)
isPrivatebooleanЧастно училище
financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
cityobject|nullГрад: {slug, name}
yearsRangearrayМасив с години
gradesobjectДанни по клас (ключ = 4/7/10/12)
grades.*.belScore / matScorearrayРезултати по години (null = няма)
grades.*.belStudents / matStudentsarrayБрой ученици по години
grades.*.latestYearnumberПоследна година с данни
grades.*.nationalRank / nationalTotalnumberНационален ранг (последна година)
grades.*.cityRank / cityTotalnumberРанг в града (последна година)
grades.*.nationalTypeRank / nationalTypeTotalnumberНационален ранг сред училищата от същия вид (financing, последна година)
grades.*.cityTypeRank / cityTypeTotalnumberРанг в града сред училищата от същия вид (последна година)
grades.*.medianRank / medianAdjustedRank / medianTotalnumber3-годишен медианен ранг
grades.*.nationalRanks / nationalTotalsarrayНационален ранг по години (като yearsRange на класа; null = няма ранг)
grades.*.cityRanks / cityTotalsarrayРанг в града по години (null = няма ранг)
▶ GET /cities.json Всички градове

Отговор

ПолеТипОписание
citiesobjectГрадове (ключ = slug, латиница)
cities.*.fullNamestringПълно име
cities.*.shortNamestringКратко име
cities.*.orderPositionnumberГрупа (1=главен, 2=областен, 3=друг)
▶ GET /cities/{slug}.json Метаданни за конкретен град

Отговор

ПолеТипОписание
slugstringSlug на града (латиница)
fullNamestringПълно име
shortNamestringКратко име
orderPositionnumberГрупа (1=главен, 2=областен, 3=друг)

По клас

▶ GET /4/data.json НВО 4 клас - всички градове и училища

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectГрадове (ключ = hrefName, латиница)
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectУчилища (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (0-100, null = няма данни)
schools.*.matScorearrayРезултати МАТ (0-100, null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ
▶ GET /7/data.json НВО 7 клас - всички градове и училища

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectГрадове (ключ = hrefName, латиница)
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectУчилища (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (0-100, null = няма данни)
schools.*.matScorearrayРезултати МАТ (0-100, null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ
▶ GET /10/data.json НВО 10 клас - всички градове и училища

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectГрадове (ключ = hrefName, латиница)
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectУчилища (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (0-100, null = няма данни)
schools.*.matScorearrayРезултати МАТ (0-100, null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ
▶ GET /12/data.json ДЗИ 12 клас - всички градове и училища

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectГрадове (ключ = hrefName, латиница)
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectУчилища (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (2-6, null = няма данни)
schools.*.matScorearrayРезултати МАТ (2-6, null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ

По град

▶ GET /{grade}/{city}/data.json Данни за конкретен град

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectСъдържа само избрания град (ключ = hrefName)
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectУчилища (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (null = няма данни)
schools.*.matScorearrayРезултати МАТ (null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ
▶ GET /{grade}/{city}/{code}.json Данни за конкретно училище

Отговор

ПолеТипОписание
gradenumberКлас
yearsRangearrayМасив с години с данни
citiesobjectСъдържа само избрания град с едно училище
cities.*.fullNamestringПълно име на града
cities.*.shortNamestringКратко име
cities.*.schoolsobjectЕдно училище (ключ = код)
schools.*.fullNamestringПълно име на училището
schools.*.shortNamestringКратко име
schools.*.isPrivatebooleanЧастно училище
schools.*.financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools.*.belScorearrayРезултати БЕЛ (null = няма данни)
schools.*.matScorearrayРезултати МАТ (null = няма данни)
schools.*.belStudentsarrayБрой ученици БЕЛ
schools.*.matStudentsarrayБрой ученици МАТ

Класации

▶ GET /rankings/median/{grade}/{year}.json Класация по медиана (3-годишен прозорец)

Отговор

ПолеТипОписание
gradenumberКлас
typestring"median"
medianYearsnumberБрой години за медианата
endYearnumberКрайна година на прозореца за изчисление на медианата
schools[]arrayСортиран списък с училища
schools[].ranknumberПозиция в класацията
schools[].adjustedRanknumber|nullПозиция с изключените училища без данни за последната година
schools[].codestringКод на училището
schools[].citiesarraySlug-ове на градовете (някои училища се водят на повече от едно място)
schools[].shortNamestringКратко име
schools[].fullNamestringПълно име
schools[].isPrivatebooleanЧастно училище
schools[].financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools[].belMediannumberМедиана БЕЛ
schools[].matMediannumberМедиана МАТ
schools[].scorenumberОбщ резултат (БЕЛ + МАТ)/2
▶ GET /rankings/{grade}/{year}.json Класация за конкретна година

Отговор

ПолеТипОписание
gradenumberКлас
typestring"year"
yearnumberГодина
schools[]arrayСортиран списък с училища
schools[].ranknumberПозиция в класацията
schools[].codestringКод на училището
schools[].citiesarraySlug-ове на градовете (някои училища се водят на повече от едно място)
schools[].shortNamestringКратко име
schools[].fullNamestringПълно име
schools[].isPrivatebooleanЧастно училище
schools[].financingstringВид според финансирането в регистъра на МОН: state (държавно), municipal (общинско), private (частно), religious (духовно)
schools[].belScorenumberРезултат БЕЛ
schools[].matScorenumberРезултат МАТ
schools[].scorenumberОбщ резултат (БЕЛ + МАТ)/2

Балове след 7 клас

Минимален и максимален бал на приетите по паралелки и класирания (РУО). В данните има дупки: за някои градове липсват години или класирания, а разбивката по пол често я няма - coverage казва какво има за всяка година.

▶ GET /balove/index.json Градовете с балове

Отговор

ПолеТипОписание
yearsarrayВсички години с данни (по всички градове)
dataUrlstringВсички градове в един файл
cities[]arrayslug, name, years (годините с данни за града), schools, profiles, url
▶ GET /balove/{city}.json Баловете за един град

Пример: balove/sofia.json

Отговор

ПолеТипОписание
cityobjectslug и name
yearsarrayГодините с данни за града (година, която я няма, е без данни)
coverage.{year}.rankingsarrayКласиранията (1-4) с данни в града за годината
coverage.{year}.genderbooleanИма ли разбивка по пол за годината
schools[]arraycode, name, fullName, isPrivate, financing (null, ако кодът го няма в регистъра на МОН), profiles[]
schools[].profiles[]arraycode, name и years - обект по година
profiles[].years.{year}array4 елемента (1-во…4-то класиране): обект или null - няма данни (паралелката е попълнена по-рано или класирането не е публикувано; виж coverage). Година без данни за паралелката липсва.
…{year}[k].min / maxnumberМинимален / максимален бал
…{year}[k].minMale / minFemale / maxMale / maxFemalenumber|nullПо пол; null - няма разбивка
▶ GET /balove/data.json Всички градове в един файл

Отговор

ПолеТипОписание
yearsarrayВсички години с данни
cities[]arrayДокументите на градовете (същите като /balove/{city}.json)

Данни: data.egov.bg · Вграждане на графики · За проекта