Novo nos conceitos (estágios, sinais, momentum, atualidade)? Comece com O que são sinais de expansão? — este guia parte do princípio de que você já os conhece e foca na seleção de endpoints.
Escolha por tarefa
Os endpoints em resumo
Expansion Search
O endpoint de descoberta. Filtre empresas por estágio de expansão, atualidade, mercado e o conjunto completo de dados firmográficos — ou passe uma
query em linguagem natural. Lista paginada de empresas.Expansion Overview
Agregados em nível de mercado: contagens por estágio, principais fluxos transfronteiriços, atividade de empresas monitoradas. Sem paginação — um snapshot de dashboard.
Company Expansion Detail
Uma empresa em um mercado: estágio atual, pontuação, presença, histórico de transições e os sinais de suporte. O snapshot por mercado.
Company Signal Events
O feed enriquecido e paginado dos eventos de sinal de uma empresa, entre tipos de sinal e uma janela de datas. O detalhamento de atividade.
Compare Company Expansions
Várias empresas lado a lado em uma única chamada, com séries semanais de sinais e seleção opcional de pares. Construído para grades de comparação.
Batch Company Expansion Summaries
Qualquer combinação de domain_search_id, domínio ou URL do LinkedIn, resolvida e retornada com os mesmos dados do Compare, além de um bloco de resumo calculado — sem empresa-alvo, sem seleção de pares.
Expansion Rankings
Uma lista leve, ranqueada por pontuação, de pares empresa/mercado — campos mínimos, sem paginação — para renderização rápida de mapas e heatmaps.
Expansion Signal Search
Consulte as próprias linhas de sinal — tipo, subtipo, força, polaridade, evento datado, fonte e URL de evidência — entre empresas e mercados. Paginado, filtrável, sem agregação por empresa.
”Detail” vs “Signal Events” — qual usar?
Este é o ponto de maior confusão, porque ambos envolvem sinais. A diferença é snapshot vs. feed:”Compare” vs “Summaries” — qual usar?
Ambos retornam os mesmos dados de expansão por empresa, lado a lado. A diferença está nos identificadores e no enquadramento:Compare Company Expansions, exibido como uma grade — mercados, momentum, pontuação de expansão e principais novas entradas, lado a lado.
Um fluxo de trabalho típico
Descobrir
Chame Expansion Search com seus filtros (ou uma
query em linguagem natural) para obter as empresas que estão se expandindo para o seu mercado-alvo. Defina is_explain_match: true para resumos de IA sobre “por que corresponde”.Detalhar uma empresa
Pegue um
domain_search_id dos resultados e chame Company Expansion Detail para a leitura completa em um mercado — estágio, presença, histórico e sinais.Ver o feed de atividade (opcional)
Para o fluxo de eventos rico e com janela de tempo, chame Company Signal Events com os tipos de sinal e o intervalo de datas que interessam.
Comparar ou mapear
Use Compare Company Expansions para uma grade lado a lado a partir de uma empresa-alvo, Batch Company Expansion Summaries quando você já tiver um conjunto de empresas e quiser métricas prontas, ou Expansion Rankings para plotar pontos ranqueados em um mapa.
Filtros compartilhados
Os endpoints de descoberta (Expansion Search, Expansion Overview, Expansion Rankings) aceitam o mesmo vocabulário de filtros — filtros de expansão (estágio, momentum, atualidade, escopo, tipos de sinal), o par de geografia direcionada (froms / tos) e o conjunto completo de dados firmográficos da empresa (setor, tecnologias, tamanho de funcionários, receita, listas salvas). Aprenda os filtros uma vez em Visão geral de filtros; os valores válidos estão em Expansion Reference e no catálogo Como funcionam os sinais de expansão.
Usando a API de Expansão
Autenticação, suas primeiras chamadas, paginação e leitura de pontuações.
Exemplo prático
Um passo a passo completo de mercado até sinal.