HitHorizons
HitHorizons позволяет работать с данными 75M+ европейских компаний из 60 стран непосредственно в продуктах Майкрософт. Обогатите программное обеспечение данными компании из различных источников, чтобы обеспечить более полную и сложную картину рынка, отдельных компаний и их эволюции с течением времени.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка HitHorizons |
| URL | https://www.hithorizons.com/services/api |
| Адрес электронной почты | support@hithorizons.com |
| Метаданные соединителя | |
|---|---|
| Publisher | FinStat, s. r. o. |
| Website | https://www.hithorizons.com/ |
| Политика конфиденциальности | https://www.hithorizons.com/legal/privacy-policy |
| Категории | Бизнес-аналитика; Продажи и CRM |
Соединитель HitHorizons позволяет интегрировать базу данных HitHorizons европейских компаний в продукты Майкрософт. Он позволяет выполнять поиск в базе данных более 75 миллионов компаний в 60 странах и использовать данные компании в решении.
Предпосылки
Для продолжения вам потребуется следующее:
- Подписка HitHorizons.
- Ключ API HitHorizons.
Получение учетных данных
Посетите https://www.hithorizons.com/services страницу, чтобы просмотреть спектр услуг, предоставляемых HitHorizons, и приобрести подписку HitHorizons.
Начало работы с соединителем
- Используйте действие Company-Search для поиска компании по имени и расположению.
- Используйте действия Company-Get для получения сведений о компании, включая базовые данные регистрации, сведения о продажах с помощью аналитики и сведения о номере сотрудника с помощью аналитики.
Известные проблемы и ограничения
Существует ограничение скорости для запросов API. Допускается максимальная скорость 30 запросов в минуту. После превышения этого ограничения возвращается ответ 429 слишком много запросов.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Поиск компаний с помощью неструктурированного запроса |
Поиск компаний с помощью неструктурированного запроса. |
| Поиск компаний с помощью структурированного запроса |
Поиск компаний с помощью структурированного запроса. |
| Получение данных сведений о компании по идентификатору |
Получение данных компании, указанной HitHorizonsId. |
Поиск компаний с помощью неструктурированного запроса
Поиск компаний с помощью неструктурированного запроса.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Значение поиска в идентификаторах компании: HitHorizonsId, DUNSNumber и NationalId
|
Ids | string |
Все доступные идентификаторы будут искать значения в этом поле: HitHorizons ID, DUNS Number и National ID. Можно указать несколько значений, разделенных пробелом. |
|
|
Значение для поиска в именах компаний и идентификаторах компаний
|
Name | string |
Имя компании и дополнительное имя будут искать это значение. Кроме того, NationalId будет искать. Если формат соответствует HitHorizonsId (начинается с H-), будет выполняться поиск hitHorizonsId. Это поле можно использовать для широкого поиска с помощью имен и идентификаторов для удобства пользователя. |
|
|
Значение для поиска по адресу компании
|
Address | string |
Адрес компании будет искать это значение. Все поля адресов будут искать (почтовый адрес, почтовый индекс, город, штат или провинция). Если имя страны присутствует в этом поле, результаты ограничены только заданной страной. |
|
|
Включение записей ветви в результаты
|
ShowBranches | boolean |
Если значение false (по умолчанию), извлекаются только основные офисы и компании с одним расположением. Если значение true, записи, помеченные как филиалы, включаются в результаты. |
|
|
Типы компаний, которые должны быть включены в результаты
|
CompanyTypes | string |
Массив типов компаний для поиска. Это значение можно указать как разделенный запятыми список значений, а не массив значений (т. е. CompanyTypes=3,13, а не CompanyTypes=3&CompanyTypes=13) См. следующий список кода для доступных значений: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Если не указано, по умолчанию используются следующие значения: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Максимальное число возвращаемых результатов
|
MaxResults | integer |
Максимальное количество возвращаемых результатов. Значение по умолчанию — 20. Максимально возможное значение равно 100. |
Возвращаемое значение
Поиск компаний с помощью структурированного запроса
Поиск компаний с помощью структурированного запроса.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Число DUNS для поиска
|
DUNSNumber | string |
Компания с предоставленным номером DUNS будет возвращена. |
|
|
Значение для поиска в именах компаний
|
CompanyName | string |
Имя компании и дополнительное имя будут искать это значение. |
|
|
Значение для поиска в национальном идентификаторе компании
|
NationalId | string |
Национальный идентификатор будет искать это значение. |
|
|
Значение для поиска по адресу компании
|
AddressUnstructured | string |
Адрес компании будет искать это значение. Все поля адресов будут искать (почтовый адрес, почтовый индекс, город, штат или провинция). Если имя страны присутствует в этом поле, результаты ограничены только заданной страной. Любой из терминов может присутствовать в любом из полей адреса. |
|
|
Значение для поиска по адресу улицы компании
|
AddressStreet | string |
Адрес улицы компании будет искать это значение. Все термины должны присутствовать в одной из линий адресов улицы. |
|
|
Значение для поиска в городе компании
|
City | string |
Город компании будет искать это значение. Все термины должны присутствовать в имени города. |
|
|
Значение для поиска в штате или провинции компании
|
StateProvince | string |
Штат или провинция компании будут искать это значение. Все термины должны присутствовать в имени штата или провинции. |
|
|
Страна, чтобы ограничить поиск в
|
Country | string |
Будут искать только компании в данной стране. |
|
|
Включение записей ветви в результаты
|
ShowBranches | boolean |
Если значение false (по умолчанию), извлекаются только основные офисы и компании с одним расположением. Если значение true, записи, помеченные как филиалы, включаются в результаты. |
|
|
Типы компаний, которые должны быть включены в результаты
|
CompanyTypes | string |
Массив типов компаний для поиска. Это значение можно указать как разделенный запятыми список значений, а не массив значений (т. е. CompanyTypes=3,13, а не CompanyTypes=3&CompanyTypes=13) См. следующий список кода для доступных значений: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Если не указано, по умолчанию используются следующие значения: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Максимальное число возвращаемых результатов
|
MaxResults | integer |
Максимальное количество возвращаемых результатов. Значение по умолчанию — 20. Максимально возможное значение равно 100. |
Возвращаемое значение
Получение данных сведений о компании по идентификатору
Получение данных компании, указанной HitHorizonsId.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор компании для получения
|
HitHorizonsId | True | string |
Идентификатор HitHorizons компании для получения. HitHorizonsId можно получить, выполнив поиск компании с помощью Company-Search или Company-SearchUnstructured операций. |
Возвращаемое значение
Определения
CompanyDetailResult
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Имя Компании
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Почтовый индекс
|
PostalCode | string | |
|
Город
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Страна
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Промышленность
|
Industry | string | |
|
LocalActivityCode
|
LocalActivityCode | string | |
|
LocalActivityCodeType
|
LocalActivityCodeType | string | |
|
СозданиеOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesLocal
|
SalesLocal | double | |
|
LocalCurrency
|
LocalCurrency | string | |
|
SalesAccuracyIndicator
|
SalesAccuracyIndicator | string | |
|
SalesUSD
|
SalesUSD | double | |
|
SalesEUR
|
SalesEUR | double | |
|
HitHorizonsSalesAnalysis
|
HitHorizonsSalesAnalysis | object | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
EmployeesNumberAccuracyIndicator
|
EmployeesNumberAccuracyIndicator | string | |
|
EmployeesNumberTotal
|
EmployeesNumberTotal | integer | |
|
EmployeesNumberTotalAccuracyIndicator
|
EmployeesNumberTotalAccuracyIndicator | string | |
|
HitHorizonsEmployeesAnalysis
|
HitHorizonsEmployeesAnalysis | object | |
|
CompanyType
|
CompanyType | integer | |
|
LocationType
|
LocationType | integer | |
|
HitHorizonsCompanyProfileURL
|
HitHorizonsCompanyProfileURL | string |
CompanyDetailResultApiResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Ошибка
|
Error | string | |
|
Result
|
Result | CompanyDetailResult |
CompanySearchResult
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Имя Компании
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Почтовый индекс
|
PostalCode | string | |
|
Город
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Страна
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Промышленность
|
Industry | string | |
|
СозданиеOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Ошибка
|
Error | string | |
|
Result
|
Result | CompanySearchResponse |