НВО API v1

НВО & ДЗИ API

Публично JSON API с резултати от НВО и ДЗИ (2018–2025)

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

Общи

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

Отговор

Поле	Тип	Описание
grades	array	Масив с обекти за всеки клас
grades[].grade	number	Клас (4, 7, 10, 12)
grades[].label	string	Четимо име
grades[].yearsRange	array	Масив с години с данни
grades[].scaleMin	number	Минимална стойност на скалата
grades[].scaleMax	number	Максимална стойност на скалата
grades[].dataUrl	string	Относителен път до пълните данни

Справочник

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

Отговор

Поле	Тип	Описание
schools	object	Училища (ключ = код)
schools.*.shortName	string	Кратко име
schools.*.fullName	string	Пълно име на училището
schools.*.website	string\|null	Уебсайт (null ако няма)
schools.*.isPrivate	boolean	Частно училище

▶ GET /schools/{code}.json Метаданни за конкретно училище

Код:

Отговор

Поле	Тип	Описание
code	string	Код на училището
shortName	string	Кратко име
fullName	string	Пълно име на училището
website	string\|null	Уебсайт (null ако няма)
isPrivate	boolean	Частно училище

▶ GET /cities.json Всички градове

Отговор

Поле	Тип	Описание
cities	object	Градове (ключ = slug, латиница)
cities.*.fullName	string	Пълно име
cities.*.shortName	string	Кратко име
cities.*.orderPosition	number	Група (1=главен, 2=областен, 3=друг)

▶ GET /cities/{slug}.json Метаданни за конкретен град

Град:

Отговор

Поле	Тип	Описание
slug	string	Slug на града (латиница)
fullName	string	Пълно име
shortName	string	Кратко име
orderPosition	number	Група (1=главен, 2=областен, 3=друг)

По клас

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

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Градове (ключ = hrefName, латиница)
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Училища (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (0–100, null = няма данни)
schools.*.matScore	array	Резултати МАТ (0–100, null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

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

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Градове (ключ = hrefName, латиница)
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Училища (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (0–100, null = няма данни)
schools.*.matScore	array	Резултати МАТ (0–100, null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

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

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Градове (ключ = hrefName, латиница)
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Училища (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (0–100, null = няма данни)
schools.*.matScore	array	Резултати МАТ (0–100, null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

▶ GET /12/data.json ДЗИ 12 клас — всички градове и училища

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Градове (ключ = hrefName, латиница)
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Училища (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (2–6, null = няма данни)
schools.*.matScore	array	Резултати МАТ (2–6, null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

По град

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

Клас: Град:

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Съдържа само избрания град (ключ = hrefName)
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Училища (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (null = няма данни)
schools.*.matScore	array	Резултати МАТ (null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

▶ GET /{grade}/{city}/{code}.json Данни за конкретно училище

Клас: Град: Училище:

Отговор

Поле	Тип	Описание
grade	number	Клас
yearsRange	array	Масив с години с данни
cities	object	Съдържа само избрания град с едно училище
cities.*.fullName	string	Пълно име на града
cities.*.shortName	string	Кратко име
cities.*.schools	object	Едно училище (ключ = код)
schools.*.fullName	string	Пълно име на училището
schools.*.shortName	string	Кратко име
schools.*.isPrivate	boolean	Частно училище
schools.*.belScore	array	Резултати БЕЛ (null = няма данни)
schools.*.matScore	array	Резултати МАТ (null = няма данни)
schools.*.belStudents	array	Брой ученици БЕЛ
schools.*.matStudents	array	Брой ученици МАТ

Класации

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

Клас: Крайна година:

Отговор

Поле	Тип	Описание
grade	number	Клас
type	string	"median"
medianYears	number	Брой години за медианата
endYear	number	Крайна година на прозореца за изчисление на медианата
schools[]	array	Сортиран списък с училища
schools[].rank	number	Позиция в класацията
schools[].adjustedRank	number\|null	Позиция с изключените училища без данни за последната година
schools[].code	string	Код на училището
schools[].cities	array	Slug-ове на градовете (някои училища се водят на повече от едно място)
schools[].shortName	string	Кратко име
schools[].fullName	string	Пълно име
schools[].isPrivate	boolean	Частно училище
schools[].belMedian	number	Медиана БЕЛ
schools[].matMedian	number	Медиана МАТ
schools[].score	number	Общ резултат (БЕЛ + МАТ)/2

▶ GET /rankings/{grade}/{year}.json Класация за конкретна година

Клас: Година:

Отговор

Поле	Тип	Описание
grade	number	Клас
type	string	"year"
year	number	Година
schools[]	array	Сортиран списък с училища
schools[].rank	number	Позиция в класацията
schools[].code	string	Код на училището
schools[].cities	array	Slug-ове на градовете (някои училища се водят на повече от едно място)
schools[].shortName	string	Кратко име
schools[].fullName	string	Пълно име
schools[].isPrivate	boolean	Частно училище
schools[].belScore	number	Резултат БЕЛ
schools[].matScore	number	Резултат МАТ
schools[].score	number	Общ резултат (БЕЛ + МАТ)/2

Данни: data.egov.bg