Отрасли и подотрасли

Данные об отраслях

Получение справочной информации об отраслях

GET запрос на industries-reference/?apikey={apikey}&format=json&page={page}

Список параметров:

Название параметра	Значение
apikey	API ключ для запроса
format	json
page	Порядковый номер страницы результатов (для последующих запросов).

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null. В случае наличия данных, вернется ответ в формате {код: описание}, например:

200

 {
  "11": "Культура и искусство, СМИ и издательская деятельность",
  "12": "Физическая культура и спорт",
  "13": "Информационные технологии и связь",
  "14": "Сельское, лесное и водное хозяйство",
  "15": "Туризм и гостеприимство",
  "16": "Государственное управление",
  "17": "Торговля и сфера услуг",
  "03": "Строительство",
  "06": "Здравоохранение",
  "07": "Образование",
  "01": "Промышленность",
  "05": "Транспорт и логистика",
  "04": "Жилищно-коммунальное хозяйство"
}

Получение справочной информации о подотраслях

GET запрос на subindustries-reference/?apikey={apikey}&format=json&page={page}

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null. В случае наличия данных, вернется ответ в формате {код: описание}, например:

200

{
  "15.01": "Туризм",
  "03.02": "Гражданское строительство (кроме зданий)",
  "05.03": "Грузовой автомобильный транспорт",
  "04.08": "Водоотведение",
  "17.02": "Торговля промышленными товарами",
  "05.04": "Трубопроводный транспорт",
  "14.08": "Лесоводство",
  ...
}

Получение справочной информации об иерархических связях отрасли и подотраслей

GET запрос на ind-subind-reference/?apikey={apikey}&format=json&page={page}

Ответы:

В случае отсутствия данных в ответе, в значении поля вернется null. В случае наличия данных, вернется ответ в формате {код_отрасли: [коды, подотраслей]}, например:

200

{
  "11": [
    "11.01",
    "11.03",
    "11.04",
    "11.05"
  ],
  "12": [
    "12.01",
    "12.02"
  ],
  "13": [
    "13.01",
    "13.02"
  ], ...
}

Список подотраслей

GET запрос на subindustries/?apikey={apikey}&format=json&page={page}

Ответ возвращает записи, каждая из которых содержит данные для подотрасли за запрашиваемый год. Если в параметрах год не передан, то возвращаются суммы и количества, подсчитанные за все годы. Единого логического идентификатора у записей нет, они идентифицируются как сочетание:

• кода подотрасли (subindustry_code)
• года (year)

Пример ответа:

В случае отсутствия данных в ответе, в значении поля вернется null.

200

{
  "count": 50,
  "page_size": 20,
  "total_pages": 3,
  "page": 1,
  "data": [
    {
      "contracts223_count": 229520,
      "contracts223_sum": 7634358324081.58,
      "contracts44_count": 194810,
      "contracts44_sum": 2460198945784.18,
      "customers223_count": 15280,
      "customers44_count": 38462,
      "industry_code": "01",
      "industry_name": "Промышленность",
      "subindustry_code": "01.08",
      "subindustry_name": "Автомобилестроение",
      "suppliers223_count": 11593,
      "suppliers44_count": 25236,
      "year": null
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

ВАЖНО Поле year может содержать как числовое значение (год), так и null. В случае, если значение не null, представленные в записи суммы и количества относятся к этому году. Если "year": null, то представленные в записи суммы и количества содержат значения за всё время.

Название поля	Тип данных	Значение
contracts223_count	number	Количество договоров по 223-ФЗ за год
contracts223_sum	number	Сумма договоров по 223-ФЗ за год
contracts44_count	number	Количество контрактов 44-ФЗ за год
contracts44_sum	number	Сумма контрактов 44-ФЗ за год
customers223_count	number	Количество заказчиков по 223-ФЗ за год
customers44_count	number	Количество заказчиков 44-ФЗ за год
industry_code	string	Код отрасли
industry_name	string	Наименование отрасли
subindustry_code	string	Код подотрасли
subindustry_name	string	Наименование подотрасли
suppliers223_count	number	Количество поставщиков по 223-ФЗ за год
suppliers44_count	number	Количество поставщиков по 44-ФЗ за год
year	null / number	Год, за который данные

422 

В случае, если передано невалидное значение параметра, например, 21 в параметре page_size

Фильтрация подотраслей

По коду подотрасли

GET запрос на: subindustries/?subindustry_code=01.08&apikey={apikey}

Если отправить в качестве параметра только код подотрасли, без уточнения параметра year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

По году

GET запрос на: subindustries/?year=2023&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

По коду отрасли

GET запрос на: subindustries/?industry_code=01&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

Если отправить в качестве параметра только код отрасли, без уточнения параметра year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

По коду подотрасли и году

GET запрос на: subindustries/?year=2023&subindustry_code=01.08&apikey={apikey}

Структура ответа 200 аналогична общей структуре ответа, описанного выше.

Список отраслей

Общий справочник

industry_code	industry_name
01	Промышленность
03	Строительство
04	Жилищно-коммунальное хозяйство
05	Транспорт и логистика
06	Здравоохранение
07	Образование
11	Культура и искусство, СМИ и издательская деятельность
12	Физическая культура и спорт
13	Информационные технологии и связь
14	Сельское, лесное и водное хозяйство
15	Туризм и гостеприимство
16	Государственное управление
17	Торговля и сфера услуг

GET запрос на: industries/?apikey={apikey}&format=json&page={page}

Ответ возвращает записи, каждая из которых содержит данные для отрасли за указанный год. Единого логического идентификатора у записей нет, они идентифицируются как:

• кода отрасли (industry_code)
• года (year), за который запрашиваются данные

Фильтрация отраслей

По году

GET запрос на: industries/?year=2024&apikey={apikey}

По коду отрасли

GET запрос на: industries/?industry_code=04&apikey={apikey}

Если отправить в качестве параметра только код отрасли, без уточнения year, то вернутся только записи, у которых "year": null, то есть только суммарные значения за всё время.

По году и коду отрасли

GET запрос на: industries/?year=2024&industry_code=04&apikey={apikey}

Общий пример ответа:

200

{
    "count": 1,
    "page_size": 20,
    "total_pages": 1,
    "page": 1,
    "data": [
        {
            "contracts223_count": 74543,
            "contracts223_sum": 501837502711.15,
            "contracts44_count": 370864,
            "contracts44_sum": 562370921889.99,
            "customers223_count": 40026,
            "customers44_count": 231148,
            "industry_code": "04",
            "industry_name": "Жилищно-коммунальное хозяйство",
            "subindustries": [
                {
                    "contracts44_sum": 12476974774.87,
                    "contracts223_sum": 90698133217.03,
                    "subindustry_code": "04.05",
                    "subindustry_name": "Газоснабжение"
                },
                {
                    "contracts44_sum": 16079678279.44,
                    "contracts223_sum": 44024169076.34,
                    "subindustry_code": "04.08",
                    "subindustry_name": "Водоотведение"
                },
                ...
            ],
            "suppliers223_count": 0,
            "suppliers44_count": 25050,
            "year": 2024
        }
    ]
}

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

ВАЖНО Поле year может содержать как числовое значение (год), так и null. В случае, если значение не null, представленные в записи суммы и количества относятся к этому году. Если "year": null, то представленные в записи суммы и количества содержат значения за всё время.

Название поля	Тип данных	Значение
contracts223_count	number	Количество договоров по 223-ФЗ за год
contracts223_sum	number	Сумма договоров по 223-ФЗ за год
contracts44_count	number	Количество контрактов 44-ФЗ за год
contracts44_sum	number	Сумма контрактов 44-ФЗ за год
customers223_count	number	Количество заказчиков по 223-ФЗ за год
customers44_count	number	Количество заказчиков 44-ФЗ за год
industry_code	string	Код отрасли
industry_name	string	Наименование отрасли
subindustries	array	Массив подотраслей, относящихся к данной отрасли
suppliers223_count	number	Количество поставщиков по 223-ФЗ за год
suppliers44_count	number	Количество поставщиков по 44-ФЗ за год
year	null / number	Год, за который данные

Описание данных в subindustries

Название поля	Тип данных	Значение
contracts44_sum	number	Сумма контрактов по 44-ФЗ за год
contracts223_sum	number	Сумма договоров 223-ФЗ за год
subindustry_code	string	Код подотрасли, относящейся к отрасли
subindustry_name	string	Наименование подотрасли, относящейся к отрасли

Топы контрактов, заказчиков и поставщиков

Подотрасли

Специальные эндпойнты, которые отображают топы-20 поставщиков и заказчиков, отсортированные по сумме или по количеству контрактов с фильтрацией по ФЗ, году и коду подотрасли.

• GET запрос на: subindustries-customers-top/ - данные по заказчикам
• GET запрос на: subindustries-suppliers-top/ - данные по поставщикам

Для каждой подотрасли, года и ФЗ используется соответствующая комбинация фильтров, а также нужно указать признак сортировки:

• -total_sum - по сумме контрактов
• -total_count - по количеству контрактов

Пример составления запроса по топу заказчиков для подотрасли с кодом 01.08, за 2024 год, по 44-ФЗ по количеству контрактов:

subindustries-customers-top/?subindustry_code=01.08&year=2024&fz=44&sort=-total_count&page=1&page_size=20&apikey={apikey}

Пример ответа:

{
  "count": 36,
  "page_size": 20,
  "total_pages": 2,
  "page": 1,
  "data": [
    {
      "customer_inn": "4207010740",
      "customer_name": "ОТДЕЛЕНИЕ ФОНДА ПЕНСИОННОГО И СОЦИАЛЬНОГО СТРАХОВАНИЯ РОССИЙСКОЙ ФЕДЕРАЦИИ ПО КЕМЕРОВСКОЙ ОБЛАСТИ - КУЗБАССУ",
      "fz": "44",
      "industry_code": "01",
      "subindustry_code": "01.08",
      "subindustry_name": "Автомобилестроение",
      "total_count": 88,
      "total_sum": 178131850.66,
      "year": 2024
    } ...

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
industry_code	string	Код отрасли
subindustry_code	string	Код подотрасли
subindustry_name	string	Наименование подотрасли
total_count	number	Общее количество контрактов заказчика в рамках подотрасли
total_sum	number	Общая сумма контрактов заказчика в рамках подотрасли
year	number	Год, за который данные

Пример составления запроса по топу поставщиков для подотрасли с кодом 01.08, за 2023 год, по 44-ФЗ по сумме контрактов:

subindustries-suppliers-top/?fz=44&subindustry_code=01.08&year=2023&sort=-total_sum&page=1&page_size=20&apikey={apikey}

{
  "count": 40,
  "page_size": 20,
  "total_pages": 2,
  "page": 1,
  "data": [
    {
      "fz": "44",
      "industry_code": "01",
      "subindustry_code": "01.08",
      "subindustry_name": "Автомобилестроение",
      "supplier_inn": "7830001910",
      "supplier_name": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"БАЛТИЙСКИЙ ЗАВОД\"",
      "total_count": 1,
      "total_sum": 24798475000,
      "year": 2023
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
supplier_inn	string	ИНН поставщика
supplier_name	string	Наименование поставщика
fz	string	ФЗ
industry_code	string	Код отрасли
subindustry_code	string	Код подотрасли
subindustry_name	string	Наименование подотрасли
total_count	number	Общее количество контрактов поставщика в рамках подотрасли
total_sum	number	Общая сумма контрактов поставщика в рамках подотрасли
year	number	Год, за который данные

• GET запрос на: /subindustries-contracts-top/ - по контрактам

Фильтры остаются теми же, это: ФЗ, код подотрасли, год. Признак сортировки только -amount_rur.

Пример запроса по топу контрактов для подотрасли с кодом 01.08, за 2024 год, по 44-ФЗ

subindustries-contracts-top/?subindustry_code=01.08&year=2024&fz=44&sort=-amount_rur&page=1&page_size=20

Пример ответа:

{
    "count": 20,
    "page_size": 20,
    "total_pages": 1,
    "page": 1,
    "data": [
        {
            "amount_rur": 57800000000.0,
            "customer_inn": "7727656790",
            "customer_name": "ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ УЧРЕЖДЕНИЕ ГОРОДА МОСКВЫ \"АВТОМОБИЛЬНЫЕ ДОРОГИ\"",
            "fz": "44",
            "industry_code": "01",
            "subindustry_code": "01.08",
            "regnum": "2772765679024000425",
            "subject": "Электронный конкурс на заключение контракта на поставку компактной коммунальной техники (включая навесное оборудование) на электрической тяге, на базе электрических шасси, предусматривающего встречные инвестиционные обязательства поставщика по созданию, модернизации, освоению ее производства на территории города Москвы",
            "year": 2024
        },
        {
            "amount_rur": 11433595701.06,
            "customer_inn": "7727656790",
            "customer_name": "ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ УЧРЕЖДЕНИЕ ГОРОДА МОСКВЫ \"АВТОМОБИЛЬНЫЕ ДОРОГИ\"",
            "fz": "44",
            "industry_code": "01",
            "subindustry_code": "01.08",
            "regnum": "2772765679024000459",
            "subject": "Аукцион в электронной форме на право заключения контракта на поставку комбинированных дорожных машин",
            "year": 2024
        },
        ...
    ]
}

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
industry_code	string	Код отрасли
subindustry_code	string	Код подотрасли
regnum	string	Номер контракта
subject	string	Предмет контракта
amount_rur	number	Сумма контракта
year	number	Год, за который данные

Отрасли

Специальные эндпойнты, которые отображают топы-20 поставщиков и заказчиков, отсортированные по сумме или по количеству контрактов с фильтрацией по ФЗ, году и коду отрасли.

• GET запрос на: industries-customers-top/ - данные по заказчикам
• GET запрос на: industries-suppliers-top/ - данные по поставщикам

Для каждой отрасли, года и ФЗ используется соответствующая комбинация фильтров, а также нужно указать признак сортировки:

• -total_sum - по сумме контрактов
• -total_count - по количеству контрактов

Пример запроса по топу заказчиков для отрасли с кодом 01, за 2023 год, по 44-ФЗ по количеству контрактов:

industries-customers-top/?fz=44&industry_code=01&year=2023&sort=-total_count&page=1&page_size=20

Пример ответа:

{
  "count": 78,
  "page_size": 20,
  "total_pages": 4,
  "page": 1,
  "data": [
    {
      "customer_inn": "7714338609",
      "customer_name": "ГОСУДАРСТВЕННОЕ КАЗЕННОЕ УЧРЕЖДЕНИЕ ГОРОДА МОСКВЫ \"АГЕНТСТВО ПО ЗАКУПКАМ (КОНТРАКТНАЯ СЛУЖБА) ДЕПАРТАМЕНТА ЗДРАВООХРАНЕНИЯ ГОРОДА МОСКВЫ\"",
      "fz": "44",
      "industry_code": "01",
      "industry_name": "Промышленность",
      "total_count": 11110,
      "total_sum": 70685434605.38,
      "year": 2023
    },...

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
industry_code	string	Код отрасли
industry_name	string	Наименование отрасли
total_count	number	Общее количество контрактов заказчика в отрасли
total_sum	number	Общая сумма по контрактам заказчика в отрасли
year	number	Год, за который данные

Пример запроса по топу поставщиков для отрасли с кодом 01, за 2023 год, по 44-ФЗ по сумме контрактов:

industries-suppliers-top/?fz=44&industry_code=01&year=2023&sort=-total_sum&page=1&page_size=20

{
  "count": 133,
  "page_size": 20,
  "total_pages": 7,
  "page": 1,
  "data": [
    {
      "fz": "44",
      "industry_code": "01",
      "industry_name": "Промышленность",
      "supplier_inn": "0274110679",
      "supplier_name": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"ФАРМСТАНДАРТ\"",
      "total_count": 2665,
      "total_sum": 92808031249.52,
      "year": 2023
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
supplier_inn	string	ИНН поставщика
supplier_name	string	Наименование поставщика
fz	string	ФЗ
industry_code	string	Код отрасли
industry_name	string	Наименование отрасли
total_count	number	Общее количество контрактов поставщика в рамках отрасли
total_sum	number	Общая сумма контрактов поставщика в рамках отрасли
year	number	Год, за который данные

• GET запрос на: /industries-contracts-top - по контрактам

Фильтры остаются теми же, это: ФЗ, код отрасли, год. Признак сортировки только -amount_rur.

Пример запроса по топу контрактов для региона с кодом 01, за 2024 год, по 44-ФЗ

industries-contracts-top/?industry_code=01&year=2024&sort=-amount_rur&page=1&page_size=20

Пример ответа:

{
  "count": 40,
  "page_size": 20,
  "total_pages": 2,
  "page": 1,
  "data": [
    {
      "amount_rur": 57800000000,
      "customer_inn": "7727656790",
      "customer_name": "ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ УЧРЕЖДЕНИЕ ГОРОДА МОСКВЫ \"АВТОМОБИЛЬНЫЕ ДОРОГИ\"",
      "fz": "44",
      "industry_code": "01",
      "prod_name": "Средство транспортное для коммунального хозяйства и содержания дорог",
      "regnum": "2772765679024000425",
      "sign_date": "2024-06-26",
      "subject": "Электронный конкурс на заключение контракта на поставку компактной коммунальной техники (включая навесное оборудование) на электрической тяге, на базе электрических шасси, предусматривающего встречные инвестиционные обязательства поставщика по созданию, модернизации, освоению ее производства на территории города Москвы",
      "year": 2024
    },

Общая информация о данных в ответе:

Название поля	Тип данных	Значение
count	number	Общее количество данных в ответе
page_size	number	Число записей результатов ответа
total_pages	number	Число страниц результатов ответа
page	number	Порядковый номер страницы результатов
data	array	Список результатов запроса

Описание данных в data

Название поля	Тип данных	Значение
customer_inn	string	ИНН заказчика
customer_name	string	Наименование заказчика
fz	string	ФЗ
industry_code	string	Код отрасли
prod_name	string	Наименование объекта закупки/товара/работы/услуги
regnum	string	Номер контракта
sign_date	string	Дата подписания контракта
subject	string	Предмет контракта
amount_rur	number	Сумма контракта
year	number	Год, за который данные

Агрегация по годам внутри подотрасли и отрасли

Можно получить данные по подотрасли с раскладкой агрегированных сумм/количеств по годам. Для этого необходимо отправить GET запрос на: subindustry/<код_подотрасли>/. Например: subindustry/01.08/

Пример ответа:

{
    "contracts223_count": 229520,
    "contracts223_sum": 7634358324081.58,
    "contracts44_count": 194513,
    "contracts44_sum": 2353702719673.79,
    "customers223_count": 15280,
    "customers44_count": 38427,
    "industry_code": "01",
    "industry_name": "Промышленность",
    "subindustry_code": "01.08",
    "subindustry_name": "Автомобилестроение",
    "suppliers223_count": 11593,
    "suppliers44_count": 25191,
    "by_year": {
        "2016": {
            "44": {
                "amount": 129731934426.92,
                "quantity": 19959,
                "customers": 8591,
                "suppliers": 5950
            },
            "223": {
                "amount": 605925753912.64,
                "quantity": 20193,
                "customers": 3575,
                "suppliers": 6923
            }
        },
        ...
    }
}

Первый уровень информации соотвествует тому, что возвращается во всех остальных ответах на запросы по подотрасли. Их примеры и описание данных описаны выше. Все числовые значения разных типов представляют собой общее количество/общую сумму за все годы.

В поле by_year представлена аггрегация данных по годам.

Аналогичным образом можно получить данные по отрасли с раскладкой агрегированных сумм/количеств по годам. Для этого необходимо отправить GET запрос на: industry/<код_отрасли>/, например: industry/01/

Рейтинг отраслей

Для рейтинга отраслей достаточно использовать общий эндпойнт отраслей с сортировкой по необходимому признаку. Примеры GET запросов приведены ниже, примеры ответов соотвествуют общей структуре ответов по отраслям, их описание дано выше. Если необходим рейтинг за всё время, а не получение данных по определенному году, достаточно убрать параметр с годом из запроса.

• по 44-ФЗ, по сумме контрактов

/industries/?sort=-contracts44_sum&year=2024

• по 223-ФЗ, по сумме контрактов

industries/?sort=-contracts223_sum&year=2024

• по 44-ФЗ, по количеству контрактов

industries/?sort=-contracts44_count&year=2024

• по 223-ФЗ, по количеству контрактов

industries/?sort=-contracts223_count&year=2024

• по 44-ФЗ, по количеству заказчиков

industries/?sort=-customers44_count&year=2024

• по 223-ФЗ, по количеству заказчиков

industries/?sort=-customers223_count&year=2024