Документация API
Доступные методы
API-доступ предоставляется в рамках премиум-подписки B2B GLOBAL, подробнее по этой ссылке
-
projects
ИнвестпроектыВыборка по году публикации, началу реализации, территории, виду объекта и другим критериям
-
tenderKeywords
Тендеры по ключевым словамВыборка по ключевым словам из тендеров, подрядчиков строительства, проектировщиков, а также из смет, приложенных к тендерам
-
tenderCustomers
Заказчики тендеровВыборка заказчиков по нужными видам тендеров за нужный период
-
tenderSuppliers
Победители тендеровВыборка победителей тендеров по нужным видам деятельности за нужный период
-
tenderTopCustomers
Топ заказчики тендеровРейтинг компаний, заказывающих нужную продукцию и услуги у нужных поставщиков
-
tenderTopSuppliers
Топ поставщиков тендеровРейтинг компаний, поставляющих нужную продукцию нужным заказчикам
-
Клиент для создания запросов к API
Примеры кода клиента для выполнения запросов к API
-
tenderTopDesigners
Топ проектировщикиРейтинг компаний, оказывающих услуги по проектировнию объектов строительства за нужный период
-
tenderTopSubcontracts
Топ подрядчики строительстваРейтинг компаний, оказывающих услуги по строительству объектов за нужный период
-
companies
Компании по регионамНужные компании в нужных регионах
-
leaders
Лидеры нужных вам рынковРейтинг компаний с максимальной выручкой на нужном вам рынке
-
contestants
Конкуренты нужных вам рынковРейтинг компаний с близким размером выручки на нужном вам рынке
-
contacts
Поиск контактов в разных источникахКонтакты из компаний, инвестпроектов, тендеров, открытых источников.
Метод projects
Инвестпроекты
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| years | array | Год(ы) публикации проекта | ||
| start_years | array | Год(ы) начала реализации проекта | ||
| object_tags | array | Виды объектов | ||
| places_tags | array | Территории | ||
| roles_tags | array | Роль компании в проекте | ||
| invest_volumes | array |
Размер инвестиций (млн руб.), пример:
100-500 - от 100 млн руб. до 500 млн руб. 500-2000 - от 500 млн руб. до 2 млрд руб. |
||
| stages | array |
Стадия, одна или несколько из списка:
предпроектные работы проектирование подготовка стройплощадки СМР и ПНР проект приостановлен проект отменен объект введен в эксплуатацию |
||
| publish_date | string |
Дата публикации проекта в формате YYYY-MM-DD
|
||
| publish_date_filter_type | string | eq |
Тип фильтра по дате публикации
eq - дата равна указанной
lt - дата меньше указанной
gt - дата больше указанной
lte - дата меньше или равна указанной
gte - дата больше или равна указанной
Применяется только если передан параметр "publish_date"
|
|
| update_date | string |
Дата последнего обновления проекта в формате YYYY-MM-DD
|
||
| update_date_filter_type | string | eq |
Тип фильтра по дате обновления
eq - дата равна указанной
lt - дата меньше указанной
gt - дата больше указанной
lte - дата меньше или равна указанной
gte - дата больше или равна указанной
Применяется только если передан параметр "update_date"
|
|
| order_by | string | publish_date |
Параметр, по которому проводится сортировка
publish_date - дата публикации update_date - дата обновления |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| id | Идентификатор |
| title | Заголовок |
| short | Краткое описание |
| text | Полное описание |
| text_premium | Премиум дополнение |
| date | Дата публикации |
| hashtags_places | Теги территорий |
| hashtags_objects | Теги объектов |
| start_year | Год начала реализации |
| invest_volume | Размер инвестиций (млн руб.) |
| geo_lat | Широта |
| geo_lon | Долгота |
| url | Ссылка на страницу инвестпроекта |
| companies[] | Список компаний, задействованных в инвестпроекте |
| └ title | - название компании |
| └ role | - роль компании в проекте |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ okpo | - ОКПО |
| └ jur_address | - юридический адрес |
| └ post_address | - почтовый адрес |
| └ capital | - уставной капитал |
| └ contacts[] | - контакты |
| └ fio | - ФИО |
| └ post | - должность |
| └ contact | - контактная информация |
| updates[] | Список обновлений инвестпроекта |
| └ date | - дата обновления |
| └ text | - текст обновления |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('projects', [
'years' => [2020],
'start_years' => [2020],
'object_tags' => ['торговый комплекс', 'автодорога', 'завод'],
'places_tags' => ['Москва', 'Московская Область'],
'roles_tags' => ['инвестор', 'заказчик'],
'invest_volumes' => ['100-500', '500-2000'],
'stages' => ['подготовка стройплощадки', 'СМР и ПНР'],
'publish_date' => '2025-01-01',
'publish_date_filter_type' => 'gte',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('projects', {
'years': [2020],
'start_years': [2020],
'object_tags': ['торговый комплекс', 'автодорога', 'завод'],
'places_tags': ['Москва', 'Московская Область'],
'roles_tags': ['инвестор', 'заказчик'],
'invest_volumes': ['100-500', '500-2000'],
'stages': ['подготовка стройплощадки', 'СМР и ПНР'],
'order_direction': 'desc',
'offset': 0,
'limit': 50,
})
Метод tenderKeywords
Тендеры по ключевым словам
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| keyword | string | да | Ключевое слово или фраза | |
| search_type | string |
Тип поиска:
exact - точное соответствие any - любые формы слова |
||
| search_list | string |
Доступные значения:
tender - только текущие tender_all - текущие и состоявшиеся тендеры tender_designers - тендеры с выбранным проектировщиком tender_subcontracts - тендеры с выбранным подрядчиком строительства tender_completed - Тендеры с любым победителем |
||
| price_start | int | Цена - от (тыс. руб.) | ||
| price_stop | int | Цена - до (тыс. руб.) | ||
| search_object | array | title |
Где искать фразу:
title - в заголовке тендера smeta_body - в приложенной смете |
|
| regions | array | Регионы поиска | ||
| tender_type | string | all |
Тип тендеров:
all - все fz - по ФЗ 224/44/94 not_fz - другие |
|
| order_type | string | weight |
Поле, по которому делать сортировку:
weight - вес ключевой фразы create_date - дата region - регион price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| id | Идентификатор |
| title | Заголовок |
| placing_type | Форма закупки |
| date_start | Дата публикации |
| date_end | Дата окончания подачи заявок |
| region | Регион |
| price | Цена |
| fz | ФЗ |
| etp | Название тендерной площадки |
| okpd2[] | Список кодов ОКПД-2 |
| contracts[] | Список компаний, победителей тендера |
| └ registration_number | - регистрационный номер контракта |
| └ company_title | - название компании |
| └ company_inn | - ИНН |
| └ company_kpp | - КПП |
| └ company_okpo | - ОКПО |
| └ company_address | - адрес |
| └ contact_person | - контактное лицо |
| └ contact_email | - адрес e-mail |
| └ contact_phone | - телефон |
| └ contact_fax | - факс |
| └ price | - цена контракта |
| └ is_ip | - индивидуальный предприниматель |
| └ create_date | - дата контракта |
| company | Компания заказчик |
| └ title | - название компании |
| └ inn | - ИНН |
| └ contact_person | - контактное лицо |
| └ contact_phone | - телефон |
| └ contact_fax | - факс |
| └ contact_email | - адрес e-mail |
| └ post_address | - почтовый адрес |
| └ fact_address | - фактический адрес |
| attachments[] | Список документов |
| └ filename | - имя файла |
| └ description | - описание |
| └ url | - ссылка на файл |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderKeywords', [
'keyword' => 'ремонт',
'search_type' => 'exact',
'search_list' => 'tender_all',
'price_start' => '10000',
'price_stop' => '12000',
'regions' => ['москва'],
'search_object' => ['title'],
'tender_type' => 'all',
'order_type' => 'create_date',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderKeywords', {
'keyword': 'ремонт',
'search_type': 'exact',
'search_list': 'tender_all',
'price_start': '10000',
'price_stop': '12000',
'regions': ['москва'],
'search_object': ['title'],
'tender_type': 'all',
'order_type': 'create_date',
'order_direction': 'desc',
'offset': 0,
'limit': 50,
})
Метод tenderCustomers
Заказчики тендеров
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| okpd2_code | array | да | Список кодов ОКПД2 | |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| price_start | int | Цена - от (тыс. руб.) | ||
| price_stop | int | Цена - до (тыс. руб.) | ||
| regions | array | Регионы поиска | ||
| order_type | string | create_date |
Поле, по которому делать сортировку:
create_date - дата region - регион price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_title | Название компании |
| company_inn | ИНН |
| company_address | Адрес компании |
| contact_person | Контактное лицо |
| contact_phone | Телефон |
| contact_email | Адрес e-mail |
| tender_id | Идентификатор тендера |
| fz | ФЗ |
| title | Заголовок тендера |
| create_date | Дата контракта |
| price | Цена |
| region | Регион |
| url | Ссылка на страницу тендера |
| okpd2_codes[] | Список кодов ОКПД2 |
| └ code | - код |
| └ name | - описание кода |
| attachments[] | Список документов |
| └ filename | - имя файла |
| └ description | - описание |
| └ url | - ссылка на файл |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderCustomers', [
'okpd2_code' => ['41', '42'],
'date' => '06-10-2020',
'date_period' => 3,
'price_start' => 1000,
'price_stop' => 2000,
'regions' => ['ростовская область'],
'order_type' => 'create_date',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderCustomers', {
'okpd2_code': ['41', '42'],
'date': '06-10-2020',
'date_period': 3,
'price_start': 1000,
'price_stop': 2000,
'regions': ['ростовская область'],
'order_type': 'create_date',
'order_direction': 'desc',
'offset': 0,
'limit': 50,
})
Метод tenderSuppliers
Победители тендеров
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| okpd2_code | array | да | Список кодов ОКПД2 | |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| price_start | int | Цена - от (тыс. руб.) | ||
| price_stop | int | Цена - до (тыс. руб.) | ||
| regions | array | Регионы поиска | ||
| order_type | string | create_date |
Поле, по которому делать сортировку:
create_date - дата region - регион price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_title | Название компании |
| company_inn | ИНН |
| company_address | Адрес компании |
| contact_person | Контактное лицо |
| contact_phone | Телефон |
| contact_email | Адрес e-mail |
| tender_id | Идентификатор тендера |
| fz | ФЗ |
| title | Заголовок тендера |
| create_date | Дата контракта |
| price | Цена |
| region | Регион |
| url | Ссылка на страницу тендера |
| okpd2_codes[] | Список кодов ОКПД2 |
| └ code | - код |
| └ name | - описание кода |
| attachments[] | Список документов |
| └ filename | - имя файла |
| └ description | - описание |
| └ url | - ссылка на файл |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderSuppliers', [
'okpd2_code' => ['41', '42'],
'date' => '06-10-2020',
'date_period' => 3,
'price_start' => 1000,
'price_stop' => 2000,
'regions' => ['ростовская область'],
'order_type' => 'create_date',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderSuppliers', {
'okpd2_code': ['41', '42'],
'date': '06-10-2020',
'date_period': 3,
'price_start': 1000,
'price_stop': 2000,
'regions': ['ростовская область'],
'order_type': 'create_date',
'order_direction': 'desc',
'offset': 0,
'limit': 50,
})
Метод tenderTopCustomers
Топ заказчики тендеров
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| company_supplier_inn | string | да | ИНН поставщика | |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| order_type | string | contract_price |
Поле, по которому делать сортировку:
create_date - дата contract_price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_title | Название компании заказчика |
| company_inn | ИНН |
| company_address | Адрес компании |
| contact_person | Контактное лицо |
| contact_phone | Телефон |
| contact_fax | Факс |
| contact_email | Адрес e-mail |
| post_address | Почтовый адрес |
| fact_address | Фактический адрес |
| contract_price | Сумма найденных контрактов с указанным поставщиком |
| tenders[] | Список тендеров |
| └ id | - идентификатор тендера |
| └ title | - заголовок тендера |
| └ placing_type | - форма закупки |
| └ date_start | - дата публикации |
| └ date_end | - дата окончания подачи заявок |
| └ region | - регион |
| └ price | - цена |
| └ fz | - ФЗ |
| └ etp | - название тендерной площадки |
| └ name | - название |
| └ url | - URL площадки |
| └ okpd2_codes[] | - список кодов ОКПД-2 |
| └ code | - код |
| └ name | - описание кода |
| └ contracts[] | - cписок контрактов |
| └ registration_number | - регистрационный номер контракта |
| └ company_title | - название компании победителя |
| └ company_inn | - ИНН |
| └ company_kpp | - КПП |
| └ company_okpo | - ОКПО |
| └ company_address | - адрес |
| └ contact_person | - контактное лицо |
| └ contact_email | - адрес e-mail |
| └ contact_phone | - телефон |
| └ contact_fax | - факс |
| └ price | - цена контракта |
| └ is_ip | - индивидуальный предприниматель |
| └ create_date | - дата контракта |
| └ attachments[] | - список документов |
| └ filename | - имя файла |
| └ description | - описание |
| └ url | - ссылка на файл |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderTopCustomers', [
'company_supplier_inn' => '4217160102',
'date' => '01-10-2020',
'date_period' => 12,
'order_type' => 'create_date',
'order_direction' => 'desc',
'limit' => 10,
'offset' => 0,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderTopCustomers', {
'company_supplier_inn': '4217160102',
'date': '01-10-2020',
'date_period': 12,
'order_type': 'create_date',
'order_direction': 'desc',
'limit': 10,
'offset': 0,
})
Метод tenderTopSuppliers
Топ поставщиков тендеров
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| company_customer_inn | string | да | ИНН заказчика | |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| order_type | string | contract_price |
Поле, по которому делать сортировку:
contract_date - дата contract_price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_type |
Тип компании поставщика
LEGAL - юр. лицо IP - индивидуальный предприниматель |
| firstname | Имя |
| lastname | Фамилия |
| company_title | Название компании поставщика |
| company_inn | ИНН |
| company_kpp | КПП |
| company_okpo | ОКПО |
| company_address | Адрес компании |
| contact_phone | Телефон |
| contact_email | Адрес e-mail |
| contract_date | Дата последнего контракта |
| contract_price | Сумма найденных контрактов с указанным заказчиком |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderTopSuppliers', [
'company_customer_inn' => '1414009962',
'date' => '01-10-2020',
'date_period' => 12,
'order_type' => 'contract_price',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 10,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderTopSuppliers', {
'company_customer_inn': '1414009962',
'date': '01-10-2020',
'date_period': 12,
'order_type': 'contract_price',
'order_direction': 'desc',
'offset': 0,
'limit': 10,
})
Метод tenderTopDesigners
Топ проектировщики за период
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| price_start | int | Цена - от (тыс. руб.) | ||
| price_stop | int | Цена - до (тыс. руб.) | ||
| regions | array | Регионы поиска | ||
| order_type | string | create_date |
Поле, по которому делать сортировку:
create_date - дата region - регион price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_title | Название компании |
| company_inn | ИНН |
| company_address | Адрес компании |
| contact_person | Контактное лицо |
| contact_phone | Телефон |
| contact_email | Адрес e-mail |
| tender_id | Идентификатор тендера |
| fz | ФЗ |
| title | Заголовок тендера |
| create_date | Дата контракта |
| price | Цена |
| region | Регион |
| okpd2_code | Код ОКПД2 |
| url | Ссылка на страницу тендера |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderTopDesigners', [
'date' => '10-10-2020',
'date_period' => 12,
'price_start' => 1000,
'price_stop' => 5000,
'regions' => ['ростовская область'],
'order_type' => 'price',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 10,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderTopDesigners', {
'date': '10-10-2020',
'date_period': 12,
'price_start': 1000,
'price_stop': 5000,
'regions': ['ростовская область'],
'order_type': 'price',
'order_direction': 'desc',
'offset': 0,
'limit': 10,
})
Метод tenderTopSubcontracts
Топ-подрядчики строительства за период
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| date | string | да | Дата начала отчёта | |
| date_period | int | да | Период (месяцев назад) | |
| price_start | int | Цена - от (тыс. руб.) | ||
| price_stop | int | Цена - до (тыс. руб.) | ||
| regions | array | Регионы поиска | ||
| order_type | string | create_date |
Поле, по которому делать сортировку:
create_date - дата region - регион price - цена |
|
| order_direction | string | desc |
Порядок сортировки
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| company_title | Название компании |
| company_inn | ИНН |
| company_address | Адрес компании |
| contact_person | Контактное лицо |
| contact_phone | Телефон |
| contact_email | Адрес e-mail |
| tender_id | Идентификатор тендера |
| fz | ФЗ |
| title | Заголовок тендера |
| create_date | Дата контракта |
| price | Цена |
| region | Регион |
| okpd2_code | Код ОКПД2 |
| url | Ссылка на страницу тендера |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('tenderTopSubcontracts', [
'date' => '10-10-2020',
'date_period' => 12,
'price_start' => 1000,
'price_stop' => 5000,
'regions' => ['москва'],
'order_type' => 'price',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 10,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('tenderTopSubcontracts', {
'date': '10-10-2020',
'date_period': 12,
'price_start': 1000,
'price_stop': 5000,
'regions': ['москва'],
'order_type': 'price',
'order_direction': 'desc',
'offset': 0,
'limit': 10,
})
Метод companies
Компании по регионам
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| okved_code | string | да | Код ОКВЭД | |
| okved_is_main | int |
Тип поиска по ОКВЭД
1 - основной 0 - любой |
||
| registration_year | int | Год создания, не позже | ||
| income_min | int | Минимальный размер годовой выручки (в тыс.руб) | ||
| income_max | int | Максимальный размер годовой выручки (в тыс.руб) | ||
| employee_count | int | Размер штата, не менее | ||
| regions | array | Регионы поиска | ||
| order_type | string | income |
Поле, по которому делать сортировку:
registration_date - дата регистрации employee_count - количество персонала income - размер выручки за прошедший отчётный период |
|
| order_direction | string | desc |
Порядок сортировки (по дате публикации)
asc - прямая desc - обратная |
|
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| title | Название компании |
| okpo | ОКПО |
| okopf | ОКОПФ |
| okfs | ОКФС |
| ogrn | ОГРН |
| inn | ИНН |
| kpp | КПП |
| address | Адрес |
| status | Статус |
| capital | Уставной капитал |
| employee_count | Размер штата (чел.) |
| registration_date | Дата регистрации |
| liquidation_date | Дата ликвидации |
| actuality_date | Дата актуализации |
| okved_list[] | Список кодов ОКВЭД |
| └ main | - основной вид деятельности |
| └ code | - код |
| └ name | - описание кода |
| finance_reports[] | Годовая выручка |
| └ year | - год |
| └ income | - размер выручки |
| managers[] | Руководители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ post | - должность |
| └ type | - тип (EMPLOYEE | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| founders[] | Учредители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ type | - тип (PHYSICAL | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| contacts[] | Контакты |
| └ source |
- источник данных
company - данные компаний
network - деловая сеть B2B NET tender - тендеры project - инвестпроекты |
| └ phone | - телефон |
| └ contact_name | - имя |
| └ contact_email | - адрес e-mail |
| └ contact_post | - должность |
| region | Регион |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('companies', [
'okved_code' => '41',
'okved_is_main' => 1,
'registration_year' => 2020,
'income_min' => 1000,
'income_max' => 5000,
'employee_count' => 10,
'regions' => ['москва'],
'order_type' => 'registration_date',
'order_direction' => 'desc',
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('companies', {
'okved_code': '41',
'okved_is_main': 1,
'registration_year': 2020,
'income_min': 1000,
'income_max': 5000,
'employee_count': 10,
'regions': ['москва'],
'order_type': 'registration_date',
'order_direction': 'desc',
'offset': 0,
'limit': 50,
})
Метод leaders
Лидеры нужных вам рынков
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| okved_code | string | да | Код ОКВЭД | |
| report_year | int | Отчётный год | ||
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| title | Название компании |
| okpo | ОКПО |
| okopf | ОКОПФ |
| okfs | ОКФС |
| ogrn | ОГРН |
| inn | ИНН |
| kpp | КПП |
| address | Адрес |
| status | Статус |
| capital | Уставной капитал |
| employee_count | Размер штата (чел.) |
| registration_date | Дата регистрации |
| liquidation_date | Дата ликвидации |
| actuality_date | Дата актуализации |
| okved_list[] | Список кодов ОКВЭД |
| └ main | - основной вид деятельности |
| └ code | - код |
| └ name | - описание кода |
| finance_reports[] | Годовая выручка |
| └ year | - год |
| └ income | - размер выручки |
| managers[] | Руководители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ post | - должность |
| └ type | - тип (EMPLOYEE | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| founders[] | Учредители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ type | - тип (PHYSICAL | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| contacts[] | Контакты |
| └ source |
- источник данных
company - данные компаний
network - деловая сеть B2B NET tender - тендеры project - инвестпроекты |
| └ phone | - телефон |
| └ contact_name | - имя |
| └ contact_email | - адрес e-mail |
| └ contact_post | - должность |
| region | Регион |
| market_volume_percent | Доля рынка компании (процентов) |
| market_volume_total | Общий объём рынка |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('leaders', [
'okved_code' => '41',
'report_year' => 2018,
'offset' => 0,
'limit' => 50,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('leaders', {
'okved_code': '41',
'report_year': 2018,
'offset': 0,
'limit': 50,
})
Метод contestants
Конкуренты нужных вам рынков
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| okved_code | string | да | Код ОКВЭД | |
| report_year | int | Отчётный год | ||
| company_income | int | Размер выручки (тыс. руб.) | ||
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| title | Название компании |
| okpo | ОКПО |
| okopf | ОКОПФ |
| okfs | ОКФС |
| ogrn | ОГРН |
| inn | ИНН |
| kpp | КПП |
| address | Адрес |
| status | Статус |
| capital | Уставной капитал |
| employee_count | Размер штата (чел.) |
| registration_date | Дата регистрации |
| liquidation_date | Дата ликвидации |
| actuality_date | Дата актуализации |
| okved_list[] | Список кодов ОКВЭД |
| └ main | - основной вид деятельности |
| └ code | - код |
| └ name | - описание кода |
| finance_reports[] | Годовая выручка |
| └ year | - год |
| └ income | - размер выручки |
| managers[] | Руководители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ post | - должность |
| └ type | - тип (EMPLOYEE | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| founders[] | Учредители |
| └ inn | - ИНН |
| └ ogrn | - ОГРН |
| └ type | - тип (PHYSICAL | LEGAL) |
| └ company_title | - название компании (если юр. лицо) |
| └ firstname | - Имя |
| └ lastname | - Фамилия |
| contacts[] | Контакты |
| └ source |
- источник данных
company - данные компаний
network - деловая сеть B2B NET tender - тендеры project - инвестпроекты |
| └ phone | - телефон |
| └ contact_name | - имя |
| └ contact_email | - адрес e-mail |
| └ contact_post | - должность |
| region | Регион |
| market_volume_percent | Доля рынка компании (процентов) |
| market_volume_total | Общий объём рынка |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('contestants', [
'okved_code' => '63.11',
'report_year' => 2018,
'company_income' => 20000,
'offset' => 0,
'limit' => 100,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('contestants', {
'okved_code': '63.11',
'report_year': 2018,
'company_income': 20000,
'offset': 0,
'limit': 100,
})
Метод contacts
Поиск контактов в разных источниках
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| query | string | да |
Поисковая фраза
(поиск по названию компании, ИНН, имени, телефону, e-mail) |
|
| field | string |
Где искать
company_title - название компании company_inn - ИНН name - имя phone - телефон email - e-mail |
||
| source | string |
Источник данных
network - деловая сеть B2B NET tender - контакты из тендеров company - контакты компаний project - контакты из инвестпроектов |
||
| offset | int | 0 | Смещение результатов запроса | |
| limit | int | 50 |
Количество записей в результате запроса
(максимальное значение: 100) |
Результат:
| Название | Описание |
| source |
Источник данных
company - данные компаний
network - деловая сеть B2B NET tender - тендеры project - инвестпроекты |
| phone | Телефон |
| company_title | Название компании |
| company_inn | ИНН |
| company_ogrn | ОГРН |
| contact_name | Имя |
| contact_email | Адрес E-mail |
| contact_post | Должность |
| url | Ссылка на страницу контакта |
Пример запроса:
PHP
Python
$api = new BBGLClientApi("user@mail.com", "password");
$result = $api->call('contacts', [
'query' => 'газпром',
'field' => 'company_title',
'source' => 'tender',
'offset' => 0,
'limit' => 10,
]);
api = BBGLClientApi('user@mail.com', 'password')
result = api.call('contacts', {
'query': 'газпром',
'field': 'company_title',
'source': 'tender',
'offset': 0,
'limit': 10,
})
Клиент для создания запросов к API
Параметры конструктора:
| Название | Тип | Обязательный | По умолчанию | Описание |
| string | да | E-mail аккаунта B2B GLOBAL | ||
| password | string | да | Пароль аккаунта B2B GLOBAL |
Параметры запроса:
| Название | Тип | Обязательный | По умолчанию | Описание |
| method | string | да | Метод API | |
| params | array | да | Параметры |
PHP
Python
class BBGLClientApi
{
const SERVER_URL = 'https://bbgl.ru/b2bapi/1.1/';
private $_email;
private $_password;
public function __construct($email, $password){
$this->_email = $email;
$this->_password = $password;
}
public function call($method, $params = []){
$url = self::SERVER_URL;
$curl = curl_init();
$query = [];
$query['method'] = $method;
$query['email'] = $this->_email;
$query['password'] = $this->_password;
$query['params'] = $params;
curl_setopt($curl, CURLOPT_VERBOSE, false);
curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($query));
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/x-www-form-urlencoded',
'Connection: keep-alive'
]);
$result = curl_exec($curl);
$result = json_decode($result, true);
curl_close($curl);
return $result;
}
}
import io
import json
import pycurl
class BBGLClientApi(object):
__apiUrl = 'https://bbgl.ru/b2bapi/1.1/'
def __init__(self, email, password):
self.__email = email
self.__password = password
def call(self, method, params = []):
query = dict()
query['method'] = method
query['email'] = self.__email
query['password'] = self.__password
query['params'] = params
c = pycurl.Curl()
data = io.BytesIO()
c.setopt(c.VERBOSE, 0)
c.setopt(c.CONNECTTIMEOUT, 10)
c.setopt(c.URL, self.__apiUrl)
c.setopt(c.POSTFIELDS, json.dumps(query))
c.setopt(c.POST, 1)
c.setopt(c.HTTPHEADER, [
'Content-Type: application/json',
'Connection: keep-alive',
])
c.setopt(c.WRITEFUNCTION, data.write)
c.perform()
response = data.getvalue()
c.close()
return json.loads(response.decode('utf8'))