Skip to main content
POST
Detalhe de expansão da empresa

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
domain_search_id
string<uuid>
obrigatório

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

country_code
string

Mercado-alvo como um código de país ISO 3166-1 alpha-2 (cca2). Omita para selecionar automaticamente o mercado mais ativo da empresa; defina is_all_markets para uma visão entre mercados de todos os mercados.

Exemplo:

"US"

is_all_markets
boolean

Retorna toda a pegada de expansão da empresa em TODOS os mercados em uma única chamada, em vez de um único mercado. Quando true, country_code é ignorado, o mercado de origem é excluído dos agregados de sinais quando pode ser identificado, data passa a ser um resumo em nível de empresa (estágio predominante, total de sinais, intervalo de datas, maior pontuação de expansão) e markets_summary lista todos os mercados. O padrão é false.

Exemplo:

false

signal_type
enum<string>

Filtra os sinais retornados para um único tipo.

Opções disponíveis:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Exemplo:

"EXEC"

query
string

Descrição em linguagem natural do que você vende, ou o perfil de comprador em relação ao qual você está avaliando esta empresa. Usado apenas para fundamentar o summary gerado por IA (veja is_explain_match); ao contrário da busca de empresas, aqui NÃO é interpretado como filtros.

Exemplo:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

Quando true e uma query é informada, summary retorna um único resumo gerado por IA da atividade de expansão desta empresa no escopo atual (o mercado selecionado, ou todos os mercados estrangeiros quando is_all_markets é true), lido em relação à sua query e fundamentado nos sinais reais da empresa com citações [n].

Exemplo:

true

window_days
integer
padrão:90

Opcional. Janela móvel (em dias) que limita o feed do summary gerado por IA. O padrão é 90 quando nem este campo nem transitioned_dates são informados. Não afeta a lista paginada signals (histórico completo).

Exemplo:

90

transitioned_dates
string<date>[]

Intervalo de datas ISO [from, to] para a janela de sinal/transição. Tem precedência sobre window_days quando ambos são informados.

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"

linkedin_url
string

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

Exemplo:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

Inclui o estágio established (operadores de longa data sem sinais de expansão ativos). O padrão é false.

Exemplo:

false

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

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

is_include_metadata
boolean

Retorna o payload completo de detalhes. O tráfego via chave de API é enxuto por padrão: o bloco model, os valores de confiança (stage.confidence em Company Expansion Detail, confidence_score em other_markets[] e em markers[] de Rankings) e os campos established_min / share_of_detected / has_known_office são todos omitidos, a menos que este valor seja true.

Exemplo:

true

summary_only
boolean

Retorna apenas o bloco de resumo de estágio (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) e omite a lista de sinais e seus agregados. Muito mais leve para visualizações de destaque/cabeçalho.

Exemplo:

true

markets_summary_full
boolean

Inclui o conjunto completo de mercados classificados como markets_summary, junto com a lista limitada other_markets.

Exemplo:

true

Resposta

Detalhe da empresa no mercado.

metadata
object
data
object

Contêiner de resultado.

signals
object[]

As linhas de sinal paginadas por trás deste par empresa/mercado — a lista de evidências. O tamanho da página e os totais vêm de metadata.pagination.

summary
object

Resumo de estágio em uma linha para o par. Apenas na primeira página.

company
object

Dados de identidade da empresa — nome, domínio, logo e URLs de redes sociais. Apenas na primeira página.

signal_group_totals
object[]

Contagens de sinais por tipo, agrupadas por dia no seu fuso horário. Apenas na primeira página.

signal_type_totals
object[]

Totais de sinais de todos os tempos por tipo de sinal. Apenas na primeira página.

signal_type_recent_totals
object[]

Totais de sinais por tipo nas últimas 12 semanas. Apenas na primeira página.

signal_weekly_totals
object[]

Contagens semanais de sinais para o mapa de calor, na mesma janela de signal_type_recent_totals. Apenas na primeira página.

evidence_breakdown
object

Consolidação de evidências por tipo de fonte, calculada a partir dos sinais retornados (redigidos). Apenas na primeira página.

presence
object

Presença física e digital observada da empresa neste mercado. Apenas na primeira página.

suppressions
object[]

Sinais suprimidos do cálculo de estágio, com o motivo de cada um. Apenas na primeira página.

timeline
object[]

Histórico de transição de estágio para este par empresa/mercado. Apenas na primeira página.

other_markets
object[]

Os outros mercados ativos da empresa. Limitado em planos restritos — veja other_markets_locked_count. Apenas na primeira página.

other_markets_locked_count
integer

Quantos mercados adicionais seu plano não retornou em other_markets. 0 quando nada foi omitido.

markets_summary
object[]

Conjunto completo de mercados classificados para esta empresa. Retornado apenas quando markets_summary_full é true, na primeira página.

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