Документация 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

Параметры конструктора:

Название Тип Обязательный По умолчанию Описание
email 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'))