API для разработчиков
Данные портала доступны в виде открытого API — в формате JSON и CSV. Авторизация не требуется, запросы разрешены из браузера, ограничений по частоте нет. Данные собраны из открытых источников; при использовании просим ссылаться на портал.
С чего начать
Запросите /api/v1/meta — там перечислены доступные годы, определения всех показателей с единицами измерения и указано, для каких метрик меньшее значение означает лучший результат. Без этого числа легко интерпретировать неверно.
curl https://indexbdd.ru/api/v1/regions?year=2022Методы
GET
/api/v1/metaСправочники и метаданные: годы, метрики, уровни безопасности, исключённые регионы, источники данных, описание методики.
GET
/api/v1/regionsВсе субъекты за один год.
yearГод данных. Доступны: 2025, 2024, 2023, 2022. По умолчанию 2022.formatjson(по умолчанию) илиcsv. CSV открывается в Excel без настройки импорта.inRatingtrue— только участвующие в ранжировании,false— только справочные.
GET
/api/v1/regions/chechnyaОдин регион по всем опубликованным годам — готовый ряд для построения динамики. Идентификатор региона совпадает с адресом его страницы на портале.
GET
/api/v1/openapi.jsonСпецификация OpenAPI 3.1 — для генерации клиента или подключения API как инструмента.
GET
/llms.txtКраткое описание портала и данных для ИИ-агентов в формате Markdown.
Показатели
Направление метрики важно: у рисков и тяжести последствий меньшее значение означает лучшую ситуацию, у интегральной оценки — наоборот.
| Поле | Показатель | Единица | Лучше |
|---|---|---|---|
score | Оценка безопасности | индекс 0…1 | больше |
socialRisk | Социальный риск | погибших на 100 000 населения | меньше |
transportRisk | Транспортный риск | погибших на 10 000 транспортных средств | меньше |
severity | Тяжесть последствий ДТП | погибших на 100 пострадавших | меньше |
killed | Погибшие | человек за год | меньше |
injured | Раненые | человек за год | меньше |
accidents | ДТП | происшествий за год | меньше |
population | Население | человек | больше |
О чём стоит помнить
- В ранжировании участвуют не все субъекты: города федерального значения и малонаселённые автономные округа несопоставимы с остальными и публикуются справочно — у них поле
inRatingравноfalse, аrankпустой. - Абсолютные числа погибших и ДТП не годятся для прямого сравнения регионов без нормировки на население или автопарк — для этого есть социальный и транспортный риск.
- Рейтинг сравнивает регионы между собой и не является оценкой работы органов власти: на место влияют плотность населения, структура дорожной сети, климат, транзитный трафик.
- Данные обновляются раз в год. Ответы кэшируются, поэтому опрашивать API часто не имеет смысла.