Señales de expansión: un ejemplo práctico

Este recorrido sigue una única pregunta — “¿Qué empresas se están expandiendo al Reino Unido en este momento, y por qué?” — desde el panel de mercado hasta las señales individuales detrás del movimiento de una empresa. Cada solicitud y respuesta a continuación usa las estructuras reales de la API de Expansión.

El escenario

Vendes a empresas que están estableciendo operaciones en el Reino Unido. Quieres identificar a los movimientos entrantes más recientes, y luego entender por qué una de esas empresas se está expandiendo, para poder ajustar el momento de tu contacto.

Paso 1 — Encontrar movimientos entrantes recientes hacia el Reino Unido

Establece tos: ["GB"] para encontrar cada empresa que se está expandiendo hacia el Reino Unido, más un filtro de recencia para ver solo empresas que están llegando activamente.

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

La respuesta resume el mercado y enumera las empresas que se expanden hacia él:

{
  "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 }
      }
    ]
  }
}

Ordena por expansion_score para poner primero a los movimientos más decisivos. Aquí, una empresa con sede en China (home_country_code: "CN") está en la etapa Expanding (expanding) en GB con una trayectoria advancing — un movimiento entrante fuerte y reciente.

Lista clasificada de empresas que se expanden a un mercado, cada una mostrando su etapa, flecha de impulso, recencia y número de señales — La misma lista clasificada, en el producto — etapa, impulso y recencia de un vistazo, para cada empresa que coincide con tus filtros.

Paso 2 — Ver el mapa de mercado completo de la empresa

Toma el domain_search_id y enumera cada mercado hacia el que se está expandiendo esa empresa.

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 }
  ]
}

La empresa se está expandiendo hacia el Reino Unido y comprometiendo recursos en Alemania — contexto útil para priorizar la región adecuada.

Los mercados de una sola empresa graficados en un mapa mundial, coloreados por etapa, con una leyenda de etapas y un feed de actividad reciente — Una empresa, cada mercado hacia el que se está moviendo, graficado — las mismas dos filas que describió el JSON anterior.

Paso 3 — Entender a fondo el movimiento hacia el Reino Unido

Profundiza en el detalle empresa-y-mercado para ver la etapa actual, las señales subyacentes, la presencia conocida y la línea de tiempo de transiciones.

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" }
  ]
}

La etapa Expanding está respaldada por una contratación senior en el Reino Unido y una oficina en Londres — evidencia concreta, no una suposición.

Paso 4 — Leer los eventos individuales

Para obtener la lista completa y paginada de eventos que impulsan el movimiento, llama al endpoint de eventos de señal con los tipos de señal que te interesan.

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"
      }
    ]
  }
}

Usa total_pages para controlar un botón de “cargar más” incrementando page hasta que alcance total_pages.

Feed de señales de expansión individuales de una empresa en un mercado, cada una con un tipo de señal, enlace de evidencia y fecha — Los eventos propiamente dichos, cada uno con su evidencia — una huella en la nube detectada, una contratación ejecutiva, una serie de anuncios geolocalizados.

Lo que acabas de hacer

Pasaste de un mercado → una lista clasificada de empresas en movimiento → la presencia completa de una empresa → las señales exactas detrás de su expansión al Reino Unido. Ese es el ciclo central de la API de Expansión: empezar amplio, acotar a una empresa y luego leer la evidencia.

Usando la API de Expansión

Autenticación, paginación y tus primeras llamadas.

Cómo funcionan las señales de expansión

El catálogo completo de valores usados anteriormente.

Base de conocimientos

Guías

Conceptos

Casos de estudio

Señales de expansión: un ejemplo práctico

El escenario

Paso 1 — Encontrar movimientos entrantes recientes hacia el Reino Unido

Paso 2 — Ver el mapa de mercado completo de la empresa

Paso 3 — Entender a fondo el movimiento hacia el Reino Unido

Paso 4 — Leer los eventos individuales

Lo que acabas de hacer

Usando la API de Expansión

Cómo funcionan las señales de expansión

​El escenario

​Paso 1 — Encontrar movimientos entrantes recientes hacia el Reino Unido

​Paso 2 — Ver el mapa de mercado completo de la empresa

​Paso 3 — Entender a fondo el movimiento hacia el Reino Unido

​Paso 4 — Leer los eventos individuales

​Lo que acabas de hacer

Usando la API de Expansión

Cómo funcionan las señales de expansión

El escenario

Paso 1 — Encontrar movimientos entrantes recientes hacia el Reino Unido

Paso 2 — Ver el mapa de mercado completo de la empresa

Paso 3 — Entender a fondo el movimiento hacia el Reino Unido

Paso 4 — Leer los eventos individuales

Lo que acabas de hacer