Sinais de Expansão: Um Exemplo Prático

Este passo a passo acompanha uma única pergunta — “Quais empresas estão se expandindo para o Reino Unido agora, e por quê?” — desde o painel de mercado até os sinais individuais por trás do movimento de uma empresa. Toda requisição e resposta abaixo usa os formatos reais da Expansion API.

O cenário

Você vende para empresas que estão montando operações no Reino Unido. Você quer os movimentos mais recentes de entrada, e depois quer entender por que uma delas está se expandindo para poder ajustar o momento do seu outreach.

Passo 1 — Encontrar movimentos recentes de entrada no Reino Unido

Defina tos: ["GB"] para encontrar toda empresa se expandindo para o Reino Unido, mais um filtro de atualidade para ver apenas empresas chegando ativamente.

POST /expansions/search
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

A resposta resume o mercado e lista as empresas que estão se expandindo para ele:

{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] },
    "aggregate": { "total_companies_with_signals": 64, "committing_count": 22, "expanding_count": 15 },
    "top_origins": [{ "home_country_code": "CN", "company_count": 18 }],
    "top_industries": [{ "industry": "Consumer Electronics", "count": 9 }]
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "company_name": "Example Corp",
        "domain": "example.com",
        "home_country_code": "CN",
        "country_code": "GB",
        "industry": "Consumer Electronics",
        "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 7 }
      }
    ]
  }
}

Ordene por expansion_score para colocar os movimentos mais decisivos primeiro. Aqui, uma empresa baseada na China (home_country_code: "CN") está no estágio Expanding (expanding) na GB com trajetória advancing — um movimento de entrada forte e recente.

Lista ranqueada de empresas se expandindo para um mercado, cada uma mostrando seu estágio, seta de momentum, atualidade e contagem de sinais — A mesma lista ranqueada, no produto — estágio, momentum e atualidade de relance, para cada empresa que corresponde aos seus filtros.

Passo 2 — Ver o mapa de mercado completo da empresa

Pegue o domain_search_id e liste todos os mercados para os quais essa empresa está se expandindo.

POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "US" },
  "data": { "market_count": 2, "dominant_stage_slug": "expanding", "total_signal_count": 194 },
  "markets_summary": [
    { "country_code": "GB", "stage_slug": "expanding", "is_home_market": false, "signal_count": 140, "distinct_type_count": 6, "latest_signal_at": "2026-07-08T02:42:23.544Z", "rank_now": 1 },
    { "country_code": "DE", "stage_slug": "committing", "is_home_market": false, "signal_count": 54, "distinct_type_count": 3, "latest_signal_at": "2026-06-20T00:00:00.000Z", "rank_now": 2 }
  ]
}

A empresa está se expandindo para o Reino Unido e comprometendo recursos na Alemanha — um contexto útil para priorizar a região certa.

Os mercados de uma única empresa plotados em um mapa-múndi, coloridos por estágio, com uma legenda de estágios e um feed de atividade recente — Uma empresa, cada mercado para o qual ela está se movendo, plotado — as mesmas duas linhas que o JSON acima descreveu.

Passo 3 — Entender o movimento no Reino Unido em profundidade

Aprofunde-se no detalhe empresa-e-mercado para ver o estágio atual, os sinais subjacentes, a presença conhecida e a linha do tempo de transição.

POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" },
  "data": {
    "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "stage_rank": 3,
    "stage_name": "Expanding",
    "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 27 }
  },
  "signals": [
    {
      "signal_type_slug": "EXEC",
      "display_label": "Hired Regional VP for UK & Ireland",
      "polarity": "expansion",
      "event_date": "2026-06-20T14:00:00.000Z"
    }
  ],
  "presence": [
    { "presence_type": "office", "address": "London, UK", "known_since": "2026-03-15T00:00:00.000Z" }
  ]
}

O estágio Expanding é sustentado por uma contratação sênior no Reino Unido e um escritório em Londres — evidência concreta, não uma suposição.

Passo 4 — Ler os eventos individuais

Para a lista completa e paginada de eventos que impulsionam o movimento, chame o endpoint de eventos de sinal com os tipos de sinal que lhe interessam.

POST /expansions/companies/pulse_events
{
  "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
  "signal_types": ["HIRE", "EXEC"],
  "window_days": 90,
  "page": 1
}

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002" },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 42, "total_pages": 2, "total_display_pages": 2, "is_timeout": false },
    "events": [
      {
        "signal_type_slug": "EXEC",
        "country_code": "GB",
        "display_label": "Hired Regional VP for UK & Ireland",
        "evidence_url": "https://www.linkedin.com/company/example-corp",
        "event_date": "2026-06-20T14:00:00.000Z"
      }
    ]
  }
}

Use total_pages para orientar um controle de “carregar mais” incrementando page até chegar em total_pages.

Feed de sinais de expansão individuais de uma empresa em um mercado, cada um com um tipo de sinal, link de evidência e data — Os próprios eventos, cada um com sua evidência — uma pegada em nuvem detectada, uma contratação executiva, uma sequência de anúncios geodirecionados.

O que você acabou de fazer

Você foi de um mercado → uma lista ranqueada de movimentos → a pegada completa de uma empresa → os sinais exatos por trás da sua expansão no Reino Unido. Esse é o ciclo central da Expansion API: comece amplo, restrinja a uma empresa e depois leia a evidência.

Usando a Expansion API

Autenticação, paginação e suas primeiras chamadas.

Como os Sinais de Expansão Funcionam

O catálogo completo de valores usado acima.

Base de Conhecimento

Guias

Conceitos

Estudos de Caso

Sinais de Expansão: Um Exemplo Prático

O cenário

Passo 1 — Encontrar movimentos recentes de entrada no Reino Unido

Passo 2 — Ver o mapa de mercado completo da empresa

Passo 3 — Entender o movimento no Reino Unido em profundidade

Passo 4 — Ler os eventos individuais

O que você acabou de fazer

Usando a Expansion API

Como os Sinais de Expansão Funcionam

​O cenário

​Passo 1 — Encontrar movimentos recentes de entrada no Reino Unido

​Passo 2 — Ver o mapa de mercado completo da empresa

​Passo 3 — Entender o movimento no Reino Unido em profundidade

​Passo 4 — Ler os eventos individuais

​O que você acabou de fazer

Usando a Expansion API

Como os Sinais de Expansão Funcionam

O cenário

Passo 1 — Encontrar movimentos recentes de entrada no Reino Unido

Passo 2 — Ver o mapa de mercado completo da empresa

Passo 3 — Entender o movimento no Reino Unido em profundidade

Passo 4 — Ler os eventos individuais

O que você acabou de fazer