> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Como os Sinais de Expansão Funcionam

> O modelo por trás dos Sinais de Expansão da Pubrio — estágios, o catálogo de tipos de sinal, presença local, pontuação, momentum, atualidade e fluxo — com os valores exatos que a Expansion API retorna.

<Info>
  A Pubrio lê cada expansão ao longo de alguns eixos independentes: o **estágio** que uma empresa alcançou, os **sinais** por trás dele, a **presença local** que ela já tem, e o **momentum**, a **atualidade** e a **direção de fluxo** do movimento. As colunas de **valor da API** abaixo são exatamente o que você verá nas respostas e pode usar para filtrar. Para uma lista sempre atualizada, chame o endpoint [Expansion Taxonomy](/pt/api-reference/endpoint/expansions/types).
</Info>

## Os Estágios de Expansão

Todo par empresa-e-mercado está em um estágio. Os estágios formam uma escada do primeiro interesse até uma operação totalmente estabelecida.

<Frame caption="Os estágios de expansão sobem em comprometimento—cada um sustentado por tipos de sinal característicos.">
  <img src="https://mintcdn.com/pubrio/SfmZ4AIyLQF87YBW/images/expansion-stage-ladder.svg?fit=max&auto=format&n=SfmZ4AIyLQF87YBW&q=85&s=a8b79dda50dc8a2f6837a3ec6446a0d9" alt="Escada de estágios: Exploring, Committing, Expanding, Scaling — subindo em comprometimento, com uma pegada estabelecida além disso." width="760" height="320" data-path="images/expansion-stage-ladder.svg" />
</Frame>

<Steps>
  <Step title="Exploring" icon="binoculars">
    `exploring` — interesse inicial: atividade de publicidade ou notícias direcionada à região, antes de qualquer comprometimento.
  </Step>

  <Step title="Committing" icon="seedling">
    `committing` — recursos entrando: parcerias, infraestrutura e outros preparativos.
  </Step>

  <Step title="Expanding" icon="plane-arrival">
    `expanding` — um ponto de apoio se forma: contratação local, liderança na região ou um escritório físico.
  </Step>

  <Step title="Scaling" icon="building-circle-check">
    `scaling` — em operação ativa: ampliando a equipe e lançando produtos localmente.
  </Step>
</Steps>

<Note>
  Um único dado de atividade não move uma empresa para um estágio superior — a Pubrio busca primeiro um padrão corroborado.
</Note>

<Frame caption="Os mesmos quatro estágios, ao vivo no mapa de expansão de uma empresa — cada mercado marcado, colorido de acordo com seu lugar na escada.">
  <img src="https://mintcdn.com/pubrio/D7-S_msGUHbXRYZf/images/expansion/global-expansion-map.png?fit=max&auto=format&n=D7-S_msGUHbXRYZf&q=85&s=2b2d2c846fc700626e4041942149e96e" alt="Mapa de expansão global de uma empresa com mercados plotados por estágio, além de uma legenda de estágios mostrando a contagem de Exploring, Committing, Expanding e Scaling" width="3022" height="1570" data-path="images/expansion/global-expansion-map.png" />
</Frame>

## Dois eixos: sinais de expansão vs. presença local

A Pubrio lê a posição de uma empresa em **dois eixos independentes**, e a API expõe ambos — por isso a mesma empresa pode mostrar um estágio de expansão ativo *e* uma pegada local estabelecida ao mesmo tempo.

<Columns cols={2}>
  <Card title="Estágio de sinal" icon="wave-pulse">
    Derivado de **sinais** de expansão ativos — contratação, anúncios, notícias, um novo escritório. Responde *"o que a empresa está fazendo para entrar nesse mercado agora?"* (`exploring` → `scaling`).
  </Card>

  <Card title="Presença local" icon="location-dot">
    Derivado da **pegada** real da empresa — o tamanho da sua equipe detectada no mercado e qualquer escritório conhecido. Responde *"o que a empresa já tem no local?"*
  </Card>
</Columns>

Eles nem sempre concordam, e isso é intencional:

* Uma empresa pode estar **`committing` ou `expanding` por sinais** enquanto já mostra uma equipe local considerável — ela tem um ponto de apoio e está aprofundando-o ativamente, não entrando do zero. A camada de presença no mercado lê isso como *scaling* / *aprofundando* em vez de uma entrada nova.
* Um mercado com presença local real, mas **sem sinais de expansão ativos**, aparece com um **`presence.level` de `established`** — um operador de longa data que não está fazendo novos movimentos no momento. Esses são excluídos das visões de nova expansão por padrão; inclua-os (`is_include_established`) quando quiser a pegada completa.

<Tip>
  `exploring` / `committing` / `expanding` / `scaling` descrevem o **movimento**; `established` e a camada de presença descrevem a **pegada**. Leia-os juntos para saber se uma empresa está entrando, se aprofundando ou simplesmente já está estabelecida.
</Tip>

## Tipos de Sinal

Cada tipo de sinal aponta para o estágio que ele mais fortemente indica. Tipos de sinal premier são indicadores de maior destaque.

<CardGroup cols={3}>
  <Card title="Publicidade" icon="bullhorn">
    `AD` · Exploring · Padrão<br />Campanhas direcionadas ao público do mercado.
  </Card>

  <Card title="Notícias" icon="newspaper">
    `NEWS` · Exploring · Padrão<br />Financiamento, parcerias e cobertura de lançamento vinculados à região.
  </Card>

  <Card title="Investimento de capital" icon="money-bill-trend-up">
    `INFRA` · Committing · **Premier**<br />Capital comprometido no mercado por meio de investimentos e aquisições.
  </Card>

  <Card title="Pegada em nuvem" icon="cloud">
    `DNS` · Committing · **Premier**<br />Infraestrutura em nuvem detectada no mercado.
  </Card>

  <Card title="Parcerias" icon="handshake">
    `PARTNER` · Committing · Padrão<br />Parcerias locais e relacionamentos de canal.
  </Card>

  <Card title="Participação em eventos / palestras" icon="microphone">
    `EVENT_PLUS` · Committing · **Premier**<br />Palestrar ou expor em um evento no mercado-alvo.
  </Card>

  <Card title="Contratação executiva" icon="user-tie">
    `EXEC` · Expanding · Padrão<br />Cargos de liderança baseados no mercado.
  </Card>

  <Card title="Escritório / presença" icon="building">
    `OFFICE` · Expanding · Padrão<br />Um escritório físico ou presença registrada.
  </Card>

  <Card title="Contratação local" icon="user-plus">
    `HIRE` · Expanding · Padrão<br />Vagas operacionais publicadas no mercado.
  </Card>

  <Card title="Escalonamento" icon="users">
    `SCALE` · Scaling · Padrão<br />Ampliando a equipe e as operações locais.
  </Card>

  <Card title="Lançamento de produto" icon="rocket">
    `PRODUCT` · Scaling · Padrão<br />Produtos ou serviços lançados localmente.
  </Card>
</CardGroup>

<Note>
  Sinais de contratação (`HIRE`, `EXEC`) costumam ser a evidência concreta mais precoce de um movimento de mercado e frequentemente indicam *qual função* está se expandindo — vendas, engenharia ou operações — através dos dados de vagas subjacentes.
</Note>

## Score de Expansão e Confiança

<Columns cols={2}>
  <Card title="Score de expansão" icon="ranking-star">
    O quão significativa e ativa é a expansão. Ordene por ele para que os movimentos mais decisivos subam ao topo de um mercado.
  </Card>

  <Card title="Confiança" icon="shield-check">
    Quanta evidência corroborante existe — uma empresa com vários sinais independentes tem leitura mais confiável do que uma que se apoia em uma única fonte.
  </Card>
</Columns>

## Momentum, atualidade e fluxo

Além do estágio, cada expansão carrega um momentum, uma atualidade e uma direção de fluxo. Esses são filtros independentes que você combina para expressar exatamente a consulta que deseja.

<Tabs>
  <Tab title="Momentum">
    A trajetória do movimento através dos estágios.

    | Momentum  | Valor da API | Significado                                           |
    | --------- | ------------ | ----------------------------------------------------- |
    | Novo      | `new`        | Acabou de aparecer.                                   |
    | Avançando | `advancing`  | Subindo os estágios — acelerando a entrada.           |
    | Estável   | `steady`     | Continuando em um nível consistente.                  |
    | Recuando  | `retreating` | Enfraquecendo ou revertendo — possivelmente recuando. |
  </Tab>

  <Tab title="Atualidade">
    O quão recente é a evidência, para que um sinal forte-mas-antigo nunca seja confundido com um atual.

    | Atualidade | Valor da API | Idade da evidência  |
    | ---------- | ------------ | ------------------- |
    | Fresh      | `fresh`      | Dentro de \~30 dias |
    | Cooling    | `cooling`    | \~30–60 dias        |
    | Stale      | `stale`      | \~60–90 dias        |
    | Cold       | `cold`       | Mais de \~90 dias   |
  </Tab>

  <Tab title="Fluxo">
    Qual lado da expansão observar, em relação aos mercados que interessam a você.

    | Fluxo   | Valor da API | Seleciona                                                      |
    | ------- | ------------ | -------------------------------------------------------------- |
    | Entrada | `inbound`    | Empresas se expandindo **para** os mercados selecionados.      |
    | Saída   | `outbound`   | Empresas se expandindo **a partir** dos mercados selecionados. |
    | Todos   | `all`        | Ambas as direções.                                             |
  </Tab>

  <Tab title="Força">
    O quão forte é um único dado de evidência.

    | Força      | Valor da API | Significado            |
    | ---------- | ------------ | ---------------------- |
    | Baixa      | `low`        | Evidência fraca.       |
    | Média      | `medium`     | Evidência moderada.    |
    | Alta       | `high`       | Evidência forte.       |
    | Muito alta | `very_high`  | Evidência muito forte. |
  </Tab>
</Tabs>

<Warning>
  A direção de fluxo (`inbound` / `outbound`) **não** é o mesmo que momentum (`advancing` / `retreating`). O fluxo trata de *qual lado da fronteira* você está observando; o momentum trata de *se o movimento está acelerando ou desacelerando*.
</Warning>

## Polaridade: expansão vs. contração

A maioria dos sinais indica crescimento, mas a Pubrio também detecta **contração** — evidência de que uma empresa está reduzindo suas operações. Cada sinal carrega uma **polaridade**, para que você possa identificar recuos com a mesma clareza que avanços (útil para monitoramento de risco de churn).

| Polaridade | Valor da API                                                           | Significado                                                              |
| ---------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Expansão   | `expansion`                                                            | Evidência de crescimento no mercado.                                     |
| Contração  | `contraction_leading`, `contraction_confirming`, `contraction_lagging` | Reduzindo operações, desde o primeiro indício até a retração confirmada. |

## Juntando tudo

<Tip>
  Um lead de alto valor é tipicamente um sinal **recente**, **avançando**, de **força alta** no **estágio** que corresponde à sua oferta, fluindo na **direção** que se encaixa no seu território — cruzado com a presença local para ver se é uma entrada do zero ou uma equipe já existente se aprofundando. A Expansion API expõe cada um desses elementos como um filtro e um campo.
</Tip>

<CardGroup cols={2}>
  <Card title="Referência de Campos" icon="list" href="/pt/knowledge-base/concepts/expansion-field-reference">
    Todo filtro de requisição e campo de resposta, com tipos e valores.
  </Card>

  <Card title="Exemplo Prático" icon="route" href="/pt/knowledge-base/concepts/expansion-signals-example">
    Acompanhe a expansão de uma empresa do início ao fim.
  </Card>
</CardGroup>