Partilhar via

HitHorizons

HitHorizons permite que você trabalhe com dados de 75M+ empresas europeias de 60 países diretamente em seus produtos Microsoft. Enriqueça o seu software com dados da empresa de várias fontes para lhe fornecer uma imagem mais completa e complexa do mercado, empresas individuais e sua evolução ao longo do tempo.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte HitHorizons
URL https://www.hithorizons.com/services/api
Email support@hithorizons.com
Metadados do conector
Editora FinStat, s. r. o.
Sítio Web https://www.hithorizons.com/
Política de privacidade https://www.hithorizons.com/legal/privacy-policy
Categorias Business Intelligence; Vendas e CRM

O conector HitHorizons permite-lhe integrar a base de dados HitHorizons de empresas europeias nos seus produtos Microsoft. Ele permite que você pesquise em um banco de dados de mais de 75 milhões de empresas em 60 países e use os dados da empresa em sua solução.

Pré-requisitos

Você precisará do seguinte para prosseguir:

  • Subscrição HitHorizons.
  • Chave da API HitHorizons.

Como obter credenciais

Por favor, visite https://www.hithorizons.com/services para ver a gama de serviços fornecidos pela HitHorizons e para comprar a assinatura HitHorizons.

Introdução ao conector

  • Use a ação Company-Search para pesquisar uma empresa por nome e localização.
  • Use a ação Company-Get para recuperar informações da empresa, incluindo dados básicos de registro, informações de vendas com análises e informações de número de funcionários com análises.

Problemas conhecidos e limitações

Há um limite de taxa para solicitações de API em vigor. É permitida uma taxa máxima de 30 pedidos por minuto. Depois de exceder esse limite, uma resposta de 429 solicitações demais é retornada.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API securestring A chave de API para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Pesquisa de empresas usando consulta estruturada

Pesquise empresas usando consulta estruturada.
Pesquisar empresas usando consulta não estruturada

Pesquise empresas usando consulta não estruturada.
Recuperar dados detalhados da empresa por ID

Recuperar dados da empresa especificada por HitHorizonsId.

Pesquisa de empresas usando consulta estruturada

ID da Operação:
Company-Search

Pesquise empresas usando consulta estruturada.

Parâmetros

Name Chave Necessário Tipo Description
Número DUNS para encontrar
 DUNSNumber string

Empresa com o Número DUNS fornecido será devolvida.
Valor a pesquisar em nomes de empresas
 CompanyName string

O nome da empresa e o nome secundário serão pesquisados por este valor.
Valor a pesquisar no ID Nacional da empresa
 NationalId string

O ID nacional será pesquisado por este valor.
Valor a pesquisar no endereço da empresa
 AddressUnstructured string

O endereço da empresa será pesquisado por este valor. Todos os campos de endereço serão pesquisados (endereço, código postal, cidade, estado/província). Quando o nome do país está presente neste campo, os resultados são limitados apenas ao país em questão. Qualquer um dos termos pode estar presente em qualquer um dos campos de endereço.
Valor a pesquisar no endereço da empresa
 AddressStreet string

O endereço da empresa será pesquisado por este valor. Todos os termos devem estar presentes em qualquer uma das linhas de endereço.
Valor a pesquisar na cidade da empresa
 City string

A cidade da empresa será pesquisada por este valor. Todos os termos devem estar presentes no nome da cidade.
Valor a pesquisar no estado/província da empresa
 StateProvince string

O estado/província da empresa será pesquisado por este valor. Todos os termos devem estar presentes no nome do estado/província.
País para limitar a pesquisa em
 Country string

Apenas as empresas do país em causa serão pesquisadas.
Se os registros de filiais devem ser incluídos nos resultados
 ShowBranches boolean

Quando false (padrão), apenas escritórios principais e empresas de localização única são recuperados. Quando verdadeiro, também os registros marcados como filiais são incluídos nos resultados.
Tipos de empresas a incluir nos resultados
 CompanyTypes string

Variedade de tipos de empresas a pesquisar. Esse valor pode ser fornecido como uma lista de valores separados por vírgula, em vez de uma matriz de valores (ou seja, CompanyTypes=3,13, em vez de CompanyTypes=3&CompanyTypes=13) Consulte a seguinte lista de códigos para obter os valores disponíveis: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Quando não fornecidos, os seguintes valores são usados por padrão: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167
Número máximo de resultados a devolver
 MaxResults integer

Número máximo de resultados a retornar. O valor padrão é 20. O valor máximo possível é 100.

Devoluções

Body
CompanySearchResponseApiResponse

Pesquisar empresas usando consulta não estruturada

ID da Operação:
Company-SearchUnstructured

Pesquise empresas usando consulta não estruturada.

Parâmetros

Name Chave Necessário Tipo Description
Valor a pesquisar em IDs de empresas: HitHorizonsId, DUNSNumber e NationalId
 Ids string

Todos os IDs disponíveis serão pesquisados pelos valores neste campo: ID HitHorizons, Número DUNS e ID Nacional. Vários valores podem ser fornecidos, separados por espaço.
Valor a pesquisar em nomes de empresas e IDs de empresas
 Name string

O nome da empresa e o nome secundário serão pesquisados por este valor. Além disso, o NationalId será pesquisado. Se o formato corresponder ao HitHorizonsId (começa com H-), HitHorizonsId será pesquisado. Este campo pode ser usado para uma pesquisa ampla usando nomes e IDs para conveniência do usuário.
Valor a pesquisar no endereço da empresa
 Address string

O endereço da empresa será pesquisado por este valor. Todos os campos de endereço serão pesquisados (endereço, código postal, cidade, estado/província). Quando o nome do país está presente neste campo, os resultados são limitados apenas ao país em questão.
Se os registros de filiais devem ser incluídos nos resultados
 ShowBranches boolean

Quando false (padrão), apenas escritórios principais e empresas de localização única são recuperados. Quando verdadeiro, também os registros marcados como filiais são incluídos nos resultados.
Tipos de empresas a incluir nos resultados
 CompanyTypes string

Variedade de tipos de empresas a pesquisar. Esse valor pode ser fornecido como uma lista de valores separados por vírgula, em vez de uma matriz de valores (ou seja, CompanyTypes=3,13, em vez de CompanyTypes=3&CompanyTypes=13) Consulte a seguinte lista de códigos para obter os valores disponíveis: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Quando não fornecidos, os seguintes valores são usados por padrão: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167
Número máximo de resultados a devolver
 MaxResults integer

Número máximo de resultados a retornar. O valor padrão é 20. O valor máximo possível é 100.

Devoluções

Body
CompanySearchResponseApiResponse

Recuperar dados detalhados da empresa por ID

ID da Operação:
Company-Get

Recuperar dados da empresa especificada por HitHorizonsId.

Parâmetros

Name Chave Necessário Tipo Description
ID da empresa a recuperar
 HitHorizonsId True string

HitHorizons ID da empresa para recuperar. HitHorizonsId pode ser recuperado pesquisando a empresa usando Company-Search ou Company-SearchUnstructured operações.

Devoluções

Body
CompanyDetailResultApiResponse

Definições

EmpresaDetailResult

Name Caminho Tipo Description
HitHorizonsId
 HitHorizonsId string
DUNSNumber
 DUNSNumber string
Nome da Empresa
 CompanyName string
EmpresaSecundárioNome
 CompanySecondaryName string
EndereçoStreetLine1
 AddressStreetLine1 string
EndereçoStreetLine2
 AddressStreetLine2 string
Código Postal
 PostalCode string
City
 City string
EstadoProvíncia
 StateProvince string
Country
 Country string
Identificação Nacional
 NationalId string
NationalIdType
 NationalIdType string
SICText
 SICText string
SICCode
 SICCode string
Indústria
 Industry string
LocalActivityCode
 LocalActivityCode string
LocalActivityCodeType
 LocalActivityCodeType string
Estabelecimento de Propriedade
 EstablishmentOfOwnership integer
VendasLocal
 SalesLocal double
Moeda local
 LocalCurrency string
SalesAccuracyIndicator
 SalesAccuracyIndicator string
VendasUSD
 SalesUSD double
VendasEUR
 SalesEUR double
HitHorizonsSalesAnalysis
 HitHorizonsSalesAnalysis object
Número de Empregados
 EmployeesNumber integer
FuncionáriosNúmeroPrecisãoIndicador
 EmployeesNumberAccuracyIndicator string
FuncionáriosNúmeroTotal
 EmployeesNumberTotal integer
FuncionáriosNúmeroTotalPrecisãoIndicador
 EmployeesNumberTotalAccuracyIndicator string
HitHorizonsAnálise de Funcionários
 HitHorizonsEmployeesAnalysis object
Tipo de Empresa
 CompanyType integer
LocationType
 LocationType integer
HitHorizonsCompanyProfileURL
 HitHorizonsCompanyProfileURL string

EmpresaDetailResultApiResponse

Name Caminho Tipo Description
Sucesso
 Success boolean
Erro
 Error string
Result
 Result CompanyDetailResult

EmpresaSearchResult

Name Caminho Tipo Description
HitHorizonsId
 HitHorizonsId string
DUNSNumber
 DUNSNumber string
Nome da Empresa
 CompanyName string
EmpresaSecundárioNome
 CompanySecondaryName string
EndereçoStreetLine1
 AddressStreetLine1 string
EndereçoStreetLine2
 AddressStreetLine2 string
Código Postal
 PostalCode string
City
 City string
EstadoProvíncia
 StateProvince string
Country
 Country string
Identificação Nacional
 NationalId string
Indústria
 Industry string
Estabelecimento de Propriedade
 EstablishmentOfOwnership integer
VendasEUR
 SalesEUR double
Número de Empregados
 EmployeesNumber integer
CompanyProfileURL
 CompanyProfileURL string

EmpresaSearchResponse

Name Caminho Tipo Description
Results
 Results array of CompanySearchResult
ResultadosContagem
 ResultsCount integer
Contagem Total
 TotalCount integer

EmpresaSearchResponseApiResponse

Name Caminho Tipo Description
Sucesso
 Success boolean
Erro
 Error string
Result
 Result CompanySearchResponse