Skip to main content
POST
Pesquisar a pegada cloud de empresas

Autorizações

pubrio-api-key
string
header
obrigatório

Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.

Corpo

application/json
providers
string[]

Limitar aos resultados que correspondam a estes fornecedores cloud ou de alojamento. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
exclude_providers
string[]

Excluir as linhas que correspondam a estes fornecedores cloud ou de alojamento. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
target_locations
string[]

Códigos de país que os resultados devem visar. Combina-se com filter_conditions como OR por predefinição — basta um corresponder.

Exemplo:
exclude_target_locations
string[]

Códigos de país que os resultados não devem visar. Combina-se com filter_conditions como OR por predefinição — basta um corresponder.

Exemplo:
cloud_regions
string[]

Limitar aos resultados que correspondam a estes regiões cloud. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
exclude_cloud_regions
string[]

Excluir as linhas que correspondam a estes regiões cloud. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
cities
string[]

Limitar aos resultados que correspondam a estes cidades. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
exclude_cities
string[]

Excluir as linhas que correspondam a estes cidades. Limitado a esta linha de pegada: um fornecedor num país.

Exemplo:
first_seen_dates
(string | null)[]

Duas datas ISO 8601 (AAAA-MM-DD) que delimitam quando a pegada foi vista pela primeira vez. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
last_seen_dates
(string | null)[]

Duas datas ISO 8601 (AAAA-MM-DD) que delimitam quando a pegada foi vista pela última vez. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
is_cross_border_only
boolean

Se true, devolve apenas linhas fora do mercado de origem da empresa. Empresas sem sede conhecida são excluídas.

Exemplo:

true

host_count
(integer | null)[]

Mínimo e máximo de hosts. Use null para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
server_count
(integer | null)[]

Mínimo e máximo de servidores (IP distintos). Use null para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
shared_server_count
(integer | null)[]

Mínimo e máximo de servidores partilhados com outras empresas. Use null para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
region_count
(integer | null)[]

Mínimo e máximo de regiões cloud. Use null para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
city_count
(integer | null)[]

Mínimo e máximo de cidades. Use null para deixar um limite em aberto. Limitado a esta linha de pegada: um fornecedor num país.

Required array length: 2 elements
Exemplo:
cloud_footprint_host_count
(integer | null)[]

Mínimo e máximo de hosts. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_server_count
(integer | null)[]

Mínimo e máximo de servidores (IP distintos). Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_shared_server_count
(integer | null)[]

Mínimo e máximo de servidores partilhados com outras empresas. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_provider_count
(integer | null)[]

Mínimo e máximo de fornecedores distintos usados pela empresa. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_country_count
(integer | null)[]

Mínimo e máximo de países onde a empresa aloja. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_cross_border_country_count
(integer | null)[]

Mínimo e máximo de países fora do mercado de origem. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_region_count
(integer | null)[]

Mínimo e máximo de regiões cloud. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
cloud_footprint_city_count
(integer | null)[]

Mínimo e máximo de cidades. Use null para deixar um limite em aberto. Contado para a empresa inteira, em todos os fornecedores e países.

Required array length: 2 elements
Exemplo:
company_locations
string[]

A localização da sede da empresa. Consulte os endpoints de location na aba Filters para mais informações.

Exemplo:
cloud_footprint_id
string<uuid>

Identificador de uma linha de pegada cloud.

Exemplo:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

Identificadores de linhas específicas, para exportar uma seleção.

Exemplo:
companies
string<uuid>[]

Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas.

domains
string[]

Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:
per_page
integer
padrão:25

Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o max_search_per_page da sua assinatura, retornado por Profile. Excedê-lo retorna HTTP 416 com o código 41676 (ou 41613 na busca de empresas e pessoas), não um conjunto de resultados limitado.

Intervalo necessário: x <= 25
Exemplo:

25

page
integer
padrão:1

Número da página, começando em 1. O teto é o max_search_page da sua assinatura (max_company_search_page para busca de empresas), retornado por Profile. Excedê-lo retorna HTTP 416.

Exemplo:

1

is_ascending_order
boolean
padrão:false

Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina true para do mais antigo para o mais recente. Não há sort_by neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint.

Exemplo:

false

cloud_footprint_providers
string[]

Empresas que usam algum destes fornecedores em qualquer lugar. providers sem prefixo restringe as linhas; este restringe as empresas.

Exemplo:
cloud_footprint_target_locations
string[]

Empresas presentes em algum destes países em qualquer parte da sua pegada.

Exemplo:
cloud_footprint_primary_provider
string[]

Empresas cujo maior fornecedor é um destes.

Exemplo:
domain
string

Um domínio de empresa usado para operações de busca de empresas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:

"pubrio.com"

domain_search_id
string<uuid>

Um identificador único para a operação de busca de empresas.

linkedin_urls
string[]

A URL completa do perfil da empresa no LinkedIn. A URL começa com http e contém linkedin.com/company/

Exemplo:
filter_conditions
object[]

Muda um filtro de array de OR (predefinição: corresponde a qualquer valor) para AND (corresponde a todos). Aplica-se a cloud_regions, exclude_cloud_regions, cities e exclude_cities.

Resposta

Linhas de pegada cloud paginadas.

The response is of type object.

Última modificação em 4 de setembro de 2026