HitHorizons
HitHorizons を使用すると、60 か国の 7,500 万 を超えるヨーロッパ企業のデータを Microsoft 製品で直接操作できます。 さまざまなソースからの企業データでソフトウェアをエンリッチし、市場や個々の企業について、また年月とともにそれらがどう発展してきたかに関する包括的かつ複合的な全体像を得ることができます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | HitHorizons のサポート |
| [URL] | https://www.hithorizons.com/services/api |
| メール | support@hithorizons.com |
| Connector Metadata | |
|---|---|
| 発行者 | FinStat, s. r. o. |
| Web サイト | https://www.hithorizons.com/ |
| プライバシー ポリシー | https://www.hithorizons.com/legal/privacy-policy |
| カテゴリ | ビジネス インテリジェンス、営業および CRM |
HitHorizons コネクタを使用すると、ヨーロッパ企業の HitHorizons データベースを Microsoft 製品に統合できます。 これにより、60 か国の 7,500 万社を超える企業のデータベースを検索し、お客様のソリューションで企業データを使用できます。
前提条件
続行するには、次のものが必要です:
- HitHorizons サブスクリプション。
- HitHorizons API キー。
資格情報の入手方法
HitHorizons が提供するさまざまなサービスを確認し、HitHorizons サブスクリプションを購入するには、https://www.hithorizons.com/services にアクセスしてください。
コネクタの使用を開始する
- Company-Search アクションを使用して、名前と場所で企業を検索します。
- Company-Get アクションを使用して、基本的な登録データ、分析を使用した販売情報、分析を使用した従業員番号情報などの会社情報を取得します。
既知の問題と制限事項
API リクエストにはレート制限があります。 1 分あたり最大 30 リクエストのレートが許可されます。 この制限を超えると、429 Too Many Requests という応答が返されます。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | この API の API キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ID で企業の詳細データを取得する |
HitHorizonsId で指定された会社のデータを取得します。 |
| 構造化クエリを使用して企業を検索する |
構造化クエリを使用して企業を検索します。 |
| 非構造化クエリを使用して企業を検索する |
非構造化クエリを使用して企業を検索します。 |
ID で企業の詳細データを取得する
HitHorizonsId で指定された会社のデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
取得する企業の ID
|
HitHorizonsId | True | string |
取得する企業の HitHorizons ID。 HitHorizonsId は、Company-Search または Company-SearchUnstructured 操作を使用して企業を検索することで取得できます。 |
戻り値
構造化クエリを使用して企業を検索する
構造化クエリを使用して企業を検索します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
検索する DUNS 番号
|
DUNSNumber | string |
提供された DUNS 番号を持つ企業が返されます。 |
|
|
企業名で検索する値
|
CompanyName | string |
この値で会社名と二次名が検索されます。 |
|
|
企業のナショナル ID で検索する値
|
NationalId | string |
この値でナショナル ID が検索されます。 |
|
|
企業の住所で検索する値
|
AddressUnstructured | string |
この値で企業の住所が検索されます。 すべての住所フィールド (番地、郵便番号、市、州/県) が検索されます。 このフィールドに国名が入力されている場合、結果は特定の国のみに限定されます。 どの住所フィールドにも任意の語句を用いることができます。 |
|
|
企業の所在地住所で検索する値
|
AddressStreet | string |
この値で企業の所在地住所が検索されます。 検索語句を所在地住所のいずれかの行に入力する必要があります。 |
|
|
企業の所在都市で検索する値
|
City | string |
この値で企業の所在都市が検索されます。 検索語句を市フィールドに入力する必要があります。 |
|
|
企業の州/県で検索する値
|
StateProvince | string |
この値で企業の州/県が検索されます。 検索語句は州/県フィールドに入力する必要があります。 |
|
|
検索条件で絞り込む国
|
Country | string |
指定された国の企業のみが検索されます。 |
|
|
結果に支社レコードを含めるかどうか
|
ShowBranches | boolean |
false (デフォルト) の場合、本社と単一ロケーションの企業のみが取得されます。 true の場合、支社としてマークされたレコードも結果に含まれます。 |
|
|
結果に含まれる企業の種類
|
CompanyTypes | string |
検索する企業の種類の配列。 この値は、値の配列ではなく、値のコンマ区切りリストとして入力することもできます (例、CompanyTypes = 3＆CompanyTypes = 13 の代わりに CompanyTypes = 3,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 です。 |
戻り値
非構造化クエリを使用して企業を検索する
非構造化クエリを使用して企業を検索します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
検索に値として使用する企業 ID: HitHorizonsId、DUNSNumber、NationalId
|
Ids | string |
このフィールドの値で使用可能なすべての ID (HitHorizons ID、DUNS 番号、およびナショナル ID) が検索されます。 スペース区切りで、複数の値を指定できます。 |
|
|
企業名と企業 ID で検索する値
|
Name | string |
この値で会社名と二次名が検索されます。 NationalId も検索に含められます。 形式が HitHorizonsId (H で始まる) に対応する場合、HitHorizonsId が検索されます。 名前と ID を使用して広範な検索に使用することができる、便利なフィールドです。 |
|
|
企業の住所で検索する値
|
Address | string |
この値で企業の住所が検索されます。 すべての住所フィールド (番地、郵便番号、市、州/県) が検索されます。 このフィールドに国名が入力されている場合、結果は特定の国のみに限定されます。 |
|
|
結果に支社レコードを含めるかどうか
|
ShowBranches | boolean |
false (デフォルト) の場合、本社と単一ロケーションの企業のみが取得されます。 true の場合、支社としてマークされたレコードも結果に含まれます。 |
|
|
結果に含まれる企業の種類
|
CompanyTypes | string |
検索する企業の種類の配列。 この値は、値の配列ではなく、値のコンマ区切りリストとして入力することもできます (例、CompanyTypes = 3＆CompanyTypes = 13 の代わりに CompanyTypes = 3,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 です。 |
戻り値
定義
CompanyDetailResult
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
CompanyName
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
PostalCode
|
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 | |
|
EstablishmentOfOwnership
|
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 | boolean | |
|
エラー
|
Error | string | |
|
結果
|
Result | CompanyDetailResult |
CompanySearchResult
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
CompanyName
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
PostalCode
|
PostalCode | string | |
|
市
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
国
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
業種
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
Success | boolean | |
|
エラー
|
Error | string | |
|
結果
|
Result | CompanySearchResponse |