Документация API
Доступные методы
API-доступ предоставляется в рамках премиум-подписки B2B GLOBAL, подробнее по этой ссылке
-
projects
ИнвестпроектыВыборка по году публикации, началу реализации, территории, виду объекта и другим критериям
-
tenderKeywords
Тендеры по ключевым словамВыборка по ключевым словам из тендеров, подрядчиков строительства, проектировщиков, а также из смет, приложенных к тендерам
-
tenderCustomers
Заказчики тендеровВыборка заказчиков по нужными видам тендеров за нужный период
-
tenderSuppliers
Победители тендеровВыборка победителей тендеров по нужным видам деятельности за нужный период
-
tenderTopCustomers
Топ заказчики тендеровРейтинг компаний, заказывающих нужную продукцию и услуги у нужных поставщиков
-
tenderTopSuppliers
Топ поставщиков тендеровРейтинг компаний, поставляющих нужную продукцию нужным заказчикам
-
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 |
Стадия, одна или несколько из списка:
предпроектные работы проектирование подготовка стройплощадки СМР и ПНР проект приостановлен проект отменен объект введен в эксплуатацию |
||
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' => ['подготовка стройплощадки', 'СМР и ПНР'],
'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'))