HitHorizons
HitHorizons stelt u in staat om rechtstreeks in uw Microsoft-producten met gegevens van 75M+ Europese bedrijven uit 60 landen te werken. Verrijk uw software met bedrijfsgegevens uit verschillende bronnen om u een completer en complexer beeld te geven van de markt, individuele bedrijven en hun evolutie in de loop van de tijd.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | HitHorizons-ondersteuning |
| URL | https://www.hithorizons.com/services/api |
| E-mailen | support@hithorizons.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | FinStat, s. r. o. |
| Webpagina | https://www.hithorizons.com/ |
| Privacybeleid | https://www.hithorizons.com/legal/privacy-policy |
| Categorieën | Business Intelligence; Verkoop en CRM |
Met de HitHorizons-connector kunt u de HitHorizons-database van Europese bedrijven in uw Microsoft-producten integreren. Hiermee kunt u zoeken in een database van meer dan 75 miljoen bedrijven in 60 landen en de bedrijfsgegevens in uw oplossing gebruiken.
Vereiste voorwaarden
U hebt het volgende nodig om door te gaan:
- HitHorizons-abonnement.
- HitHorizons API-sleutel.
Referenties ophalen
https://www.hithorizons.com/services Bezoek om het scala aan diensten van HitHorizons te bekijken en om HitHorizons-abonnement aan te schaffen.
Aan de slag met uw connector
- Gebruik actie Company-Search om te zoeken naar een bedrijf op naam en locatie.
- Gebruik actie Company-Get om bedrijfsgegevens op te halen, waaronder basisregistratiegegevens, verkoopgegevens met analyses en gegevens over werknemersnummers met analyses.
Bekende problemen en beperkingen
Er is een frequentielimiet voor API-aanvragen. Maximumsnelheid van 30 aanvragen per minuut is toegestaan. Nadat deze limiet is overschreden, wordt een antwoord van 429 te veel aanvragen geretourneerd.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| API-sleutel | beveiligde string | De API-sleutel voor deze API | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Bedrijfsgegevens ophalen op id |
Haal de gegevens van het bedrijf op die zijn opgegeven door HitHorizonsId. |
| Bedrijven zoeken die een gestructureerde query gebruiken |
Bedrijven zoeken die gestructureerde query's gebruiken. |
| Bedrijven zoeken die ongestructureerde query gebruiken |
Bedrijven zoeken die ongestructureerde query's gebruiken. |
Bedrijfsgegevens ophalen op id
Haal de gegevens van het bedrijf op die zijn opgegeven door HitHorizonsId.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id van het bedrijf dat moet worden opgehaald
|
HitHorizonsId | True | string |
HitHorizons-id van het bedrijf dat moet worden opgehaald. HitHorizonsId kan worden opgehaald door te zoeken naar het bedrijf met behulp van Company-Search of Company-SearchUnstructured bewerkingen. |
Retouren
Bedrijven zoeken die een gestructureerde query gebruiken
Bedrijven zoeken die gestructureerde query's gebruiken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
DUNS-nummer om te zoeken
|
DUNSNumber | string |
Bedrijf met het opgegeven DUNS-nummer wordt geretourneerd. |
|
|
Waarde om te zoeken in bedrijfsnamen
|
CompanyName | string |
Bedrijfsnaam en secundaire naam worden gezocht naar deze waarde. |
|
|
Waarde om te zoeken in de nationale id van het bedrijf
|
NationalId | string |
De nationale id wordt gezocht naar deze waarde. |
|
|
Waarde om te zoeken in bedrijfsadres
|
AddressUnstructured | string |
Het bedrijfsadres wordt naar deze waarde gezocht. Alle adresvelden worden doorzocht (adres, postcode, plaats, provincie). Wanneer de landnaam aanwezig is in dit veld, zijn de resultaten alleen beperkt tot het opgegeven land. Alle termen kunnen aanwezig zijn in een van de adresvelden. |
|
|
Waarde om te zoeken in bedrijfsadres
|
AddressStreet | string |
Het adres van het bedrijf wordt naar deze waarde gezocht. Alle termen moeten aanwezig zijn in een van de adresregels. |
|
|
Waarde om te zoeken in bedrijfsstad
|
City | string |
De plaats van het bedrijf wordt naar deze waarde gezocht. Alle termen moeten aanwezig zijn in de plaatsnaam. |
|
|
Waarde om te zoeken in bedrijfsstatus/provincie
|
StateProvince | string |
De bedrijfsstatus/provincie wordt naar deze waarde gezocht. Alle termen moeten aanwezig zijn in de naam van de staat/provincie. |
|
|
Land om de zoekopdracht te beperken in
|
Country | string |
Alleen bedrijven in het opgegeven land worden doorzocht. |
|
|
Of vertakkingsrecords moeten worden opgenomen in resultaten
|
ShowBranches | boolean |
Wanneer onwaar (standaard) worden alleen hoofdkantoren en bedrijven met één locatie opgehaald. Als waar, worden ook records die als filialen zijn gemarkeerd, opgenomen in de resultaten. |
|
|
Bedrijfstypen die moeten worden opgenomen in de resultaten
|
CompanyTypes | string |
Matrix van bedrijfstypen die moeten worden gezocht. Deze waarde kan worden opgegeven als een door komma's gescheiden lijst met waarden, in plaats van een matrix met waarden (bijvoorbeeld CompanyTypes=3,13, in plaats van CompanyTypes=3&CompanyTypes=13) Raadpleeg de volgende codelijst voor beschikbare waarden: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Wanneer deze niet is opgegeven, worden de volgende waarden standaard gebruikt: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maximum aantal resultaten dat moet worden geretourneerd
|
MaxResults | integer |
Maximum aantal resultaten dat moet worden geretourneerd. De standaardwaarde is 20. De maximaal mogelijke waarde is 100. |
Retouren
Bedrijven zoeken die ongestructureerde query gebruiken
Bedrijven zoeken die ongestructureerde query's gebruiken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Waarde om te zoeken in bedrijfs-id's: HitHorizonsId, DUNSNumber en NationalId
|
Ids | string |
Alle beschikbare id's worden gezocht naar de waarden in dit veld: HitHorizons-id, DUNS-nummer en nationale id. Er kunnen meerdere waarden worden opgegeven, gescheiden door spatie. |
|
|
Waarde om te zoeken in bedrijfsnamen en bedrijfs-id's
|
Name | string |
Bedrijfsnaam en secundaire naam worden gezocht naar deze waarde. Ook wordt NationalId doorzocht. Als de notatie overeenkomt met de HitHorizonsId (begint met H-), wordt HitHorizonsId doorzocht. Dit veld kan worden gebruikt voor algemene zoekopdrachten met behulp van namen en id's voor het gemak van de gebruiker. |
|
|
Waarde om te zoeken in bedrijfsadres
|
Address | string |
Het bedrijfsadres wordt naar deze waarde gezocht. Alle adresvelden worden doorzocht (adres, postcode, plaats, provincie). Wanneer de landnaam aanwezig is in dit veld, zijn de resultaten alleen beperkt tot het opgegeven land. |
|
|
Of vertakkingsrecords moeten worden opgenomen in resultaten
|
ShowBranches | boolean |
Wanneer onwaar (standaard) worden alleen hoofdkantoren en bedrijven met één locatie opgehaald. Als waar, worden ook records die als filialen zijn gemarkeerd, opgenomen in de resultaten. |
|
|
Bedrijfstypen die moeten worden opgenomen in de resultaten
|
CompanyTypes | string |
Matrix van bedrijfstypen die moeten worden gezocht. Deze waarde kan worden opgegeven als een door komma's gescheiden lijst met waarden, in plaats van een matrix met waarden (bijvoorbeeld CompanyTypes=3,13, in plaats van CompanyTypes=3&CompanyTypes=13) Raadpleeg de volgende codelijst voor beschikbare waarden: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType Wanneer deze niet is opgegeven, worden de volgende waarden standaard gebruikt: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Maximum aantal resultaten dat moet worden geretourneerd
|
MaxResults | integer |
Maximum aantal resultaten dat moet worden geretourneerd. De standaardwaarde is 20. De maximaal mogelijke waarde is 100. |
Retouren
Definities
CompanyDetailResult
| Name | Pad | Type | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Bedrijfsnaam
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Postcode
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Industrie
|
Industry | string | |
|
LocalActivityCode
|
LocalActivityCode | string | |
|
LocalActivityCodeType
|
LocalActivityCodeType | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesLocal
|
SalesLocal | double | |
|
LocalCurrency
|
LocalCurrency | string | |
|
SalesAccuracyIndicator
|
SalesAccuracyIndicator | string | |
|
SalesALES
|
SalesUSD | double | |
|
VerkoopEUR
|
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 | Pad | Type | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Fout
|
Error | string | |
|
Resultaat
|
Result | CompanyDetailResult |
CompanySearchResult
| Name | Pad | Type | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Bedrijfsnaam
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Postcode
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Industrie
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
VerkoopEUR
|
SalesEUR | double | |
|
EmployeesNumber
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
CompanySearchResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Fout
|
Error | string | |
|
Resultaat
|
Result | CompanySearchResponse |