HitHorizons
HitHorizons ermöglicht Es Ihnen, mit Daten von 75M+ europäischen Unternehmen aus 60 Ländern direkt in Ihren Microsoft-Produkten zu arbeiten. Bereichern Sie Software mit Unternehmensdaten aus verschiedenen Quellen, um Ihnen ein umfassenderes und komplexeres Bild des Marktes, einzelner Unternehmen und deren Entwicklung im Laufe der Zeit zu bieten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | HitHorizons-Unterstützung |
| URL | https://www.hithorizons.com/services/api |
| support@hithorizons.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | FinStat, s. r. o. |
| Webseite | https://www.hithorizons.com/ |
| Datenschutzrichtlinie | https://www.hithorizons.com/legal/privacy-policy |
| Kategorien | Business Intelligence; Vertrieb und CRM |
HitHorizons Connector ermöglicht es Ihnen, Die HitHorizons-Datenbank europäischer Unternehmen in Ihre Microsoft-Produkte zu integrieren. Sie können in einer Datenbank von mehr als 75 Millionen Unternehmen in 60 Ländern suchen und die Unternehmensdaten in Ihrer Lösung verwenden.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- HitHorizons-Abonnement.
- HitHorizons-API-Schlüssel.
So erhalten Sie Anmeldeinformationen
https://www.hithorizons.com/services Besuchen Sie bitte, um die Von HitHorizons bereitgestellten Dienste anzuzeigen und hitHorizons-Abonnement zu kaufen.
Erste Schritte mit Ihrem Connector
- Verwenden Sie die Aktion Company-Search, um nach einem Unternehmen nach Namen und Standort zu suchen.
- Verwenden Sie Aktion Company-Get, um Unternehmensinformationen abzurufen, einschließlich grundlegender Registrierungsdaten, Vertriebsinformationen mit Analysen und Mitarbeiternummerninformationen mit Analysen.
Bekannte Probleme und Einschränkungen
Es gibt ein Satzlimit für API-Anforderungen. Die maximale Rate von 30 Anforderungen pro Minute ist zulässig. Nach Überschreitung dieses Grenzwerts wird eine Antwort auf 429 zu viele Anforderungen zurückgegeben.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Unternehmensdetaildaten nach ID |
Dient zum Abrufen von Daten des Unternehmens, das von HitHorizonsId angegeben wurde. |
| Suchen nach Unternehmen mit strukturierter Abfrage |
Suchen Sie nach Unternehmen mit strukturierter Abfrage. |
| Suchen nach Unternehmen mit unstrukturierter Abfrage |
Suchen Sie nach Unternehmen, die eine unstrukturierte Abfrage verwenden. |
Abrufen von Unternehmensdetaildaten nach ID
Dient zum Abrufen von Daten des Unternehmens, das von HitHorizonsId angegeben wurde.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
ID des abzurufenden Unternehmens
|
HitHorizonsId | True | string |
HitHorizons-ID des abzurufenden Unternehmens. HitHorizonsId kann abgerufen werden, indem sie mithilfe von Company-Search oder Company-SearchUnstructured Vorgängen nach dem Unternehmen suchen. |
Gibt zurück
Suchen nach Unternehmen mit strukturierter Abfrage
Suchen Sie nach Unternehmen mit strukturierter Abfrage.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
DUNS Number to find
|
DUNSNumber | string |
Das Unternehmen mit der angegebenen DUNS-Nummer wird zurückgegeben. |
|
|
Wert für die Suche in Firmennamen
|
CompanyName | string |
Der Firmenname und der sekundäre Name werden nach diesem Wert gesucht. |
|
|
Wert für die Suche in der nationalen Unternehmens-ID
|
NationalId | string |
Die nationale ID wird nach diesem Wert durchsucht. |
|
|
Wert, der in der Unternehmensadresse gesucht werden soll
|
AddressUnstructured | string |
Die Firmenadresse wird nach diesem Wert gesucht. Alle Adressfelder werden durchsucht (Straße, Postleitzahl, Ort, Bundesland/Kanton). Wenn der Name des Landes in diesem Feld vorhanden ist, sind die Ergebnisse nur auf das angegebene Land beschränkt. Jeder der Begriffe kann in einem der Adressfelder vorhanden sein. |
|
|
Wert, der in der Firmenadresse gesucht werden soll
|
AddressStreet | string |
Die Firmenadresse wird nach diesem Wert durchsucht. Alle Begriffe müssen in einer der Adresszeilen vorhanden sein. |
|
|
Wert, der in der Unternehmensstadt gesucht werden soll
|
City | string |
Die Firmenstadt wird nach diesem Wert gesucht. Alle Begriffe müssen im Stadtnamen vorhanden sein. |
|
|
Wert für die Suche im Bundesland/der Provinz
|
StateProvince | string |
Nach diesem Wert wird nach dem Bundesland/der Provinz gesucht. Alle Begriffe müssen im Namen des Bundeslandes/der Provinz vorhanden sein. |
|
|
Land, in dem die Suche eingeschränkt werden soll
|
Country | string |
Nur Unternehmen im angegebenen Land werden durchsucht. |
|
|
Gibt an, ob Verzweigungseinträge in Ergebnisse eingeschlossen werden sollen.
|
ShowBranches | boolean |
Wenn "false" (Standardeinstellung) werden nur Hauptniederlassungen und Ein-Standort-Unternehmen abgerufen. Wenn true, werden auch Datensätze, die als Zweigstellen gekennzeichnet sind, in die Ergebnisse einbezogen. |
|
|
Unternehmenstypen, die in die Ergebnisse einbezogen werden sollen
|
CompanyTypes | string |
Array von Unternehmenstypen, nach der gesucht werden soll. Dieser Wert kann als durch Trennzeichen getrennte Liste von Werten bereitgestellt werden, anstelle eines Arrays von Werten (d. h. CompanyTypes=3,13 , anstelle von CompanyTypes=3&CompanyTypes=13) Verweisen Sie auf die folgende Codeliste für verfügbare Werte: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Wenn nicht angegeben, werden die folgenden Werte standardmäßig verwendet: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maximale Anzahl der zurückzugebenden Ergebnisse
|
MaxResults | integer |
Maximale Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 20. Der maximal mögliche Wert ist 100. |
Gibt zurück
Suchen nach Unternehmen mit unstrukturierter Abfrage
Suchen Sie nach Unternehmen, die eine unstrukturierte Abfrage verwenden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Wert für die Suche in Unternehmens-IDs: HitHorizonsId, DUNSNumber und NationalId
|
Ids | string |
Alle verfügbaren IDs werden nach den Werten in diesem Feld durchsucht: HitHorizons ID, DUNS Number und National ID. Mehrere Werte können durch Leerzeichen getrennt bereitgestellt werden. |
|
|
Wert für die Suche in Firmennamen und Firmen-IDs
|
Name | string |
Der Firmenname und der sekundäre Name werden nach diesem Wert gesucht. Außerdem wird NationalId durchsucht. Wenn das Format der HitHorizonsId entspricht (beginnt mit H-), wird HitHorizonsId durchsucht. Dieses Feld kann für die allgemeine Suche mithilfe von Namen und IDs für die Benutzerfreundlichkeit verwendet werden. |
|
|
Wert, der in der Unternehmensadresse gesucht werden soll
|
Address | string |
Die Firmenadresse wird nach diesem Wert gesucht. Alle Adressfelder werden durchsucht (Straße, Postleitzahl, Ort, Bundesland/Kanton). Wenn der Name des Landes in diesem Feld vorhanden ist, sind die Ergebnisse nur auf das angegebene Land beschränkt. |
|
|
Gibt an, ob Verzweigungseinträge in Ergebnisse eingeschlossen werden sollen.
|
ShowBranches | boolean |
Wenn "false" (Standardeinstellung) werden nur Hauptniederlassungen und Ein-Standort-Unternehmen abgerufen. Wenn true, werden auch Datensätze, die als Zweigstellen gekennzeichnet sind, in die Ergebnisse einbezogen. |
|
|
Unternehmenstypen, die in die Ergebnisse einbezogen werden sollen
|
CompanyTypes | string |
Array von Unternehmenstypen, nach der gesucht werden soll. Dieser Wert kann als durch Trennzeichen getrennte Liste von Werten bereitgestellt werden, anstelle eines Arrays von Werten (d. h. CompanyTypes=3,13 , anstelle von CompanyTypes=3&CompanyTypes=13) Verweisen Sie auf die folgende Codeliste für verfügbare Werte: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Wenn nicht angegeben, werden die folgenden Werte standardmäßig verwendet: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maximale Anzahl der zurückzugebenden Ergebnisse
|
MaxResults | integer |
Maximale Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 20. Der maximal mögliche Wert ist 100. |
Gibt zurück
Definitionen
CompanyDetailResult
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Firmenname
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Postleitzahl
|
PostalCode | string | |
|
Stadt
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Branche
|
Industry | string | |
|
LocalActivityCode
|
LocalActivityCode | string | |
|
LocalActivityCodeType
|
LocalActivityCodeType | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesLocal
|
SalesLocal | double | |
|
LocalCurrency
|
LocalCurrency | string | |
|
SalesAccuracyIndicator
|
SalesAccuracyIndicator | string | |
|
SalesUSD
|
SalesUSD | double | |
|
UmsatzEUR
|
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
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Fehler
|
Error | string | |
|
Ergebnis
|
Result | CompanyDetailResult |
CompanySearchResult
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Firmenname
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Postleitzahl
|
PostalCode | string | |
|
Stadt
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Branche
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
UmsatzEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ergebnisse
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Fehler
|
Error | string | |
|
Ergebnis
|
Result | CompanySearchResponse |