HitHorizons
HitHorizons umożliwia pracę z danymi 75 mln europejskich firm z 60 krajów bezpośrednio w produktach firmy Microsoft. Wzbogacanie oprogramowania za pomocą danych firmowych z różnych źródeł w celu zapewnienia bardziej kompletnego i złożonego obrazu rynku, poszczególnych firm i ich ewolucji w czasie.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa aplikacji HitHorizons |
| adres URL | https://www.hithorizons.com/services/api |
| support@hithorizons.com |
| Metadane łącznika | |
|---|---|
| Publisher | FinStat, s. r. o. |
| Witryna internetowa | https://www.hithorizons.com/ |
| Zasady ochrony prywatności | https://www.hithorizons.com/legal/privacy-policy |
| Kategorie | Analiza biznesowa; Sprzedaż i CRM |
Łącznik HitHorizons umożliwia integrację bazy danych HitHorizons europejskich firm z produktami firmy Microsoft. Umożliwia ona wyszukiwanie w bazie danych ponad 75 milionów firm w 60 krajach i korzystanie z danych firmowych w rozwiązaniu.
Wymagania wstępne
Aby kontynuować, musisz wykonać następujące czynności:
- Subskrypcja HitHorizons.
- Klucz interfejsu API HitHorizons.
Jak uzyskać poświadczenia
Odwiedź stronę https://www.hithorizons.com/services , aby wyświetlić zakres usług oferowanych przez HitHorizons i kupić subskrypcję HitHorizons.
Wprowadzenie do łącznika
- Użyj akcji Company-Search, aby wyszukać firmę według nazwy i lokalizacji.
- Użyj Company-Get akcji, aby pobrać informacje o firmie, w tym podstawowe dane rejestracji, informacje o sprzedaży z analizą i informacje o numerze pracownika z analizą.
Znane problemy i ograniczenia
Istnieje limit szybkości żądań interfejsu API. Maksymalna szybkość 30 żądań na minutę jest dozwolona. Po przekroczeniu tego limitu zostanie zwrócona odpowiedź 429 Zbyt wiele żądań.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API dla tego interfejsu API | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie danych szczegółów firmy według identyfikatora |
Pobieranie danych firmy określonej przez HitHorizonsId. |
| Wyszukiwanie firm przy użyciu zapytania bez struktury |
Wyszukaj firmy przy użyciu zapytania bez struktury. |
| Wyszukiwanie firm przy użyciu zapytania ustrukturyzowanego |
Wyszukaj firmy przy użyciu zapytania ustrukturyzowanego. |
Pobieranie danych szczegółów firmy według identyfikatora
Pobieranie danych firmy określonej przez HitHorizonsId.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator firmy do pobrania
|
HitHorizonsId | True | string |
Identyfikator HitHorizons firmy do pobrania. Identyfikator HitHorizonsId można pobrać, wyszukując firmę przy użyciu operacji Company-Search lub Company-SearchUnstructured. |
Zwraca
Wyszukiwanie firm przy użyciu zapytania bez struktury
Wyszukaj firmy przy użyciu zapytania bez struktury.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Wartość do wyszukiwania w identyfikatorach firmowych: HitHorizonsId, DUNSNumber i NationalId
|
Ids | string |
Wszystkie dostępne identyfikatory zostaną wyszukane w tym polu: Identyfikator HitHorizons, numer DUNS i identyfikator narodowy. Można podać wiele wartości rozdzielonych spacjami. |
|
|
Wartość do wyszukiwania w nazwach firm i identyfikatorach firm
|
Name | string |
Nazwa firmy i nazwa pomocnicza zostaną wyszukane dla tej wartości. Ponadto przeszukany zostanie identyfikator NationalId. Jeśli format odpowiada identyfikatorowi HitHorizonsId (rozpoczyna się od H-), wyszukiwany będzie identyfikator HitHorizonsId. To pole może służyć do szerokiego wyszukiwania przy użyciu nazw i identyfikatorów dla wygody użytkownika. |
|
|
Wartość do wyszukiwania w adresie firmy
|
Address | string |
Adres firmy zostanie wyszukany dla tej wartości. Wszystkie pola adresów zostaną przeszukane (adres ulicy, kod pocztowy, miasto, województwo). Jeśli nazwa kraju jest obecna w tym polu, wyniki są ograniczone tylko do danego kraju. |
|
|
Czy uwzględnić rekordy gałęzi w wynikach
|
ShowBranches | boolean |
W przypadku wartości false (wartość domyślna) pobierane są tylko główne biura i firmy z jedną lokalizacją. W przypadku wartości true rekordy oznaczone jako biura oddziału są uwzględniane w wynikach. |
|
|
Typy firm, które mają zostać uwzględnione w wynikach
|
CompanyTypes | string |
Tablica typów firm do wyszukania. Tę wartość można podać jako rozdzielaną przecinkami listę wartości zamiast tablicy wartości (tj. CompanyTypes=3,13, zamiast CompanyTypes=3&CompanyTypes=13) zapoznaj się z następującą listą kodową dostępnych wartości: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Jeśli nie podano, domyślnie są używane następujące wartości: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maksymalna liczba wyników do zwrócenia
|
MaxResults | integer |
Maksymalna liczba wyników do zwrócenia. Wartość domyślna to 20. Maksymalna możliwa wartość to 100. |
Zwraca
Wyszukiwanie firm przy użyciu zapytania ustrukturyzowanego
Wyszukaj firmy przy użyciu zapytania ustrukturyzowanego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Numer DUNS do znalezienia
|
DUNSNumber | string |
Firma z podanym numerem DUNS zostanie zwrócona. |
|
|
Wartość do wyszukiwania w nazwach firm
|
CompanyName | string |
Nazwa firmy i nazwa pomocnicza zostaną wyszukane dla tej wartości. |
|
|
Wartość do wyszukania w identyfikatorze narodowym firmy
|
NationalId | string |
Identyfikator krajowy zostanie wyszukany dla tej wartości. |
|
|
Wartość do wyszukiwania w adresie firmy
|
AddressUnstructured | string |
Adres firmy zostanie wyszukany dla tej wartości. Wszystkie pola adresów zostaną przeszukane (adres ulicy, kod pocztowy, miasto, województwo). Jeśli nazwa kraju jest obecna w tym polu, wyniki są ograniczone tylko do danego kraju. Dowolny z terminów może być obecny w dowolnym polu adresu. |
|
|
Wartość do wyszukiwania w adresie ulicy firmy
|
AddressStreet | string |
Adres ulicy firmy zostanie wyszukany dla tej wartości. Wszystkie terminy muszą być obecne w jednej z linii adresów ulicznych. |
|
|
Wartość do wyszukiwania w mieście firmy
|
City | string |
Miasto firmy zostanie wyszukane dla tej wartości. Wszystkie terminy muszą być obecne w nazwie miasta. |
|
|
Wartość do wyszukiwania w stanie/prowincji firmy
|
StateProvince | string |
Stan/prowincja firmy zostaną wyszukane dla tej wartości. Wszystkie terminy muszą być obecne w nazwie stanu/prowincji. |
|
|
Kraj, aby ograniczyć wyszukiwanie w
|
Country | string |
Przeszukane zostaną tylko firmy w danym kraju. |
|
|
Czy uwzględnić rekordy gałęzi w wynikach
|
ShowBranches | boolean |
W przypadku wartości false (wartość domyślna) pobierane są tylko główne biura i firmy z jedną lokalizacją. W przypadku wartości true rekordy oznaczone jako biura oddziału są uwzględniane w wynikach. |
|
|
Typy firm, które mają zostać uwzględnione w wynikach
|
CompanyTypes | string |
Tablica typów firm do wyszukania. Tę wartość można podać jako rozdzielaną przecinkami listę wartości zamiast tablicy wartości (tj. CompanyTypes=3,13, zamiast CompanyTypes=3&CompanyTypes=13) zapoznaj się z następującą listą kodową dostępnych wartości: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Jeśli nie podano, domyślnie są używane następujące wartości: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maksymalna liczba wyników do zwrócenia
|
MaxResults | integer |
Maksymalna liczba wyników do zwrócenia. Wartość domyślna to 20. Maksymalna możliwa wartość to 100. |
Zwraca
Definicje
CompanyDetailResult
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DunSNumber
|
DUNSNumber | string | |
|
Nazwa firmy
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Kod pocztowy
|
PostalCode | string | |
|
Miejscowość
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Przemysł
|
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 | |
|
Liczba pracowników
|
EmployeesNumber | integer | |
|
EmployeesNumberAccuracyIndicator
|
EmployeesNumberAccuracyIndicator | string | |
|
EmployeesNumberTotal
|
EmployeesNumberTotal | integer | |
|
EmployeesNumberTotalAccuracyIndicator
|
EmployeesNumberTotalAccuracyIndicator | string | |
|
HitHorizonsEmployeesAnalysis
|
HitHorizonsEmployeesAnalysis | object | |
|
Typ firmy
|
CompanyType | integer | |
|
LocationType
|
LocationType | integer | |
|
HitHorizonsCompanyProfileURL
|
HitHorizonsCompanyProfileURL | string |
CompanyDetailResultApiResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
Success | boolean | |
|
Error
|
Error | string | |
|
Wynik
|
Result | CompanyDetailResult |
CompanySearchResult
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DunSNumber
|
DUNSNumber | string | |
|
Nazwa firmy
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Kod pocztowy
|
PostalCode | string | |
|
Miejscowość
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Przemysł
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
Liczba pracowników
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Powodzenie
|
Success | boolean | |
|
Error
|
Error | string | |
|
Wynik
|
Result | CompanySearchResponse |