> ## 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.
# Elegir un endpoint de Expansion
> Una guía de tarea a endpoint para la API de Expansion — qué endpoint llamar para descubrimiento, detalle de empresa, el feed de señales, comparación, mapas y valores de referencia.
La API de Expansion es un pequeño conjunto de endpoints, cada uno responde a una pregunta distinta sobre cómo las empresas crecen hacia nuevos mercados. Esta guía relaciona **lo que quieres hacer** con **qué endpoint llamar**, para que nunca tengas que adivinar.
¿Eres nuevo en los conceptos (etapas, señales, momentum, actualidad)? Empieza con [¿Qué son las señales de expansión?](/es/knowledge-base/concepts/expansion-signals) — esta guía asume que ya los conoces y se centra en la selección de endpoints.
## Elige según la tarea
| Quieres… | Llama a |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| **Encontrar empresas** que se están expandiendo a un mercado (por filtros o una consulta en lenguaje natural) | [Expansion Search](/es/api-reference/endpoint/expansions/market_lookup) |
| Ver **KPIs y flujos a nivel de mercado** (conteos por etapa, corredores principales) | [Expansion Overview](/es/api-reference/endpoint/expansions/dashboard) |
| Obtener el **estado de una empresa en un mercado** — etapa, presencia, historial y las señales detrás de él | [Company Expansion Detail](/es/api-reference/endpoint/expansions/company_lookup) |
| Obtener el **feed enriquecido y acotado por fechas** de los eventos de señal de una empresa | [Company Signal Events](/es/api-reference/endpoint/expansions/company_pulse_events) |
| **Comparar** la expansión de varias empresas en paralelo, a partir de una empresa objetivo | [Compare Company Expansions](/es/api-reference/endpoint/expansions/company_compare) |
| Obtener **métricas de comparación listas para mostrar** (mercados, momentum, puntuación de expansión) para un conjunto de empresas que ya tienes — por dominio, URL de LinkedIn o id | [Batch Company Expansion Summaries](/es/api-reference/endpoint/expansions/company_summaries) |
| Graficar **puntos clasificados de empresa/mercado** en un mapa o mapa de calor | [Expansion Rankings](/es/api-reference/endpoint/expansions/company_markers) |
| Leer las **filas de señal en bruto** detrás de una etapa — auditar la evidencia, o construir tu propio scoring | [Expansion Signal Search](/es/api-reference/endpoint/expansions/signal_search) |
| Resolver **valores de filtro y enumeraciones** (etapas, tipos de señal, actualidad…) | [Expansion Reference](/es/api-reference/endpoint/expansions/types) |
## Los endpoints de un vistazo
El endpoint de descubrimiento. Filtra empresas por etapa de expansión, actualidad, mercado y todo el conjunto de datos firmográficos de la empresa — o pasa una `query` en lenguaje natural. Lista de empresas paginada.
Agregados a nivel de mercado: conteos por etapa, principales flujos transfronterizos, actividad de empresas vigiladas. Sin paginación — una instantánea de dashboard.
Una empresa en un mercado: etapa actual, puntuación, presencia, historial de transiciones y las señales que lo respaldan. La instantánea por mercado.
El feed enriquecido y paginado de los eventos de señal de una empresa, a través de tipos de señal y una ventana de fechas. El desglose de actividad.
Varias empresas en paralelo en una sola llamada, con series de señales semanales y siembra de pares opcional. Diseñado para cuadrículas comparativas.
Cualquier combinación de domain\_search\_id, dominio o URL de LinkedIn, resuelta y devuelta con los mismos datos que Compare más un bloque de resumen calculado — sin empresa objetivo, sin siembra de pares.
Una lista ligera y clasificada por puntuación de pares empresa/mercado — campos mínimos, sin paginación — para renderizar mapas y mapas de calor rápidamente.
Consulta directamente las filas de señal — tipo, subtipo, fuerza, polaridad, evento con fecha, fuente y URL de evidencia — a través de empresas y mercados. Paginado, filtrable, sin agregación por empresa.
## "Detail" frente a "Signal Events" — ¿cuál elegir?
Este es el punto de confusión más común, porque **ambos involucran señales**. La diferencia es *instantánea frente a feed*:
| | Company Expansion Detail | Company Signal Events |
| ---------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Alcance** | una empresa × **un mercado** | una empresa, a través de **todos sus mercados extranjeros** |
| **Mercados** | un **único mercado** vía `country_code`, o toda la empresa a la vez vía `is_all_markets` | **todos los mercados extranjeros** por defecto (se excluye el mercado local); acótalo a mercados específicos con `country_codes` (array) |
| **Devuelve** | etapa, puntuación, presencia, historial **+ señales de respaldo** | **eventos de señal enriquecidos** (URLs de evidencia, listados de contratación, etiquetas) |
| **Tiempo** | posición actual | una **ventana de fechas** que eliges (`window_days` — por defecto 90 — o `transitioned_dates`) |
| **Forma** | un objeto de instantánea estructurado | un feed de eventos paginado ("cargar más") |
| **Úsalo cuando** | "¿Cuál es el estado de esta empresa en **un** mercado, y por qué?" | "Muéstrame el flujo completo a través de **todos** los mercados que impulsan la expansión de esta empresa" |
**La mayoría de las integraciones solo necesitan Company Expansion Detail** — ya devuelve las señales detrás de la etapa de una empresa en un mercado. Recurre a **Company Signal Events** cuando quieras específicamente el flujo de eventos rico, filtrable y acotado por fechas (por ejemplo, para construir una interfaz de línea de tiempo de actividad).
## "Compare" frente a "Summaries" — ¿cuál elegir?
Ambos devuelven los mismos datos de expansión por empresa en paralelo. La diferencia está en *los identificadores y el enfoque*:
| | Compare Company Expansions | Batch Company Expansion Summaries |
| ---------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Entrada** | cualquier combinación de `domain_search_id`, `domain` o `linkedin_url` | cualquier combinación de `domain_search_id`, `domain` o `linkedin_url` |
| **Siembra de pares** | opcional, vía `seed_target` | ninguna — cada empresa es independiente |
| **Agregado calculado** | ninguno (calcula tú mismo mercados/momentum/puntuación) | bloque `summary` incluido por empresa (mercados activos/nuevos, momentum, puntuación de expansión, mezcla de etapas) |
| **Úsalo cuando** | ya tienes ids resueltos y quieres sembrar pares comparables para un objetivo | te dan empresas por dominio o URL de LinkedIn y quieres métricas de comparación listas para mostrar en una sola llamada |
**¿Estás construyendo una cuadrícula de benchmarking de competidores alrededor de una empresa objetivo?** Usa **Compare** con `seed_target` para seleccionar pares automáticamente. **¿Ya tienes un conjunto de empresas** (una watchlist, una importación de CRM, una lista de dominios) **y solo quieres los números?** Usa **Batch Company Expansion Summaries** — te ahorra tener que reimplementar el cálculo de momentum/puntuación en el cliente.
## Un flujo de trabajo típico
Llama a **Expansion Search** con tus filtros (o una `query` en lenguaje natural) para obtener las empresas que se están expandiendo a tu mercado objetivo. Configura `is_explain_match: true` para resúmenes de IA sobre "por qué coincide".
Toma un `domain_search_id` de los resultados y llama a **Company Expansion Detail** para obtener la lectura completa en un mercado — etapa, presencia, historial y señales.
Para el flujo de eventos rico y acotado por fechas, llama a **Company Signal Events** con los tipos de señal y el rango de fechas que te interesen.
Usa **Compare Company Expansions** para una cuadrícula comparativa sembrada a partir de una empresa objetivo, **Batch Company Expansion Summaries** cuando ya tengas un conjunto de empresas y quieras métricas listas para usar, o **Expansion Rankings** para graficar puntos clasificados en un mapa.
## Filtros compartidos
Los endpoints de descubrimiento (**Expansion Search**, **Expansion Overview**, **Expansion Rankings**) aceptan el mismo vocabulario de filtros — filtros de expansión (etapa, momentum, actualidad, alcance, tipos de señal), el par de geografía dirigida (`froms` / `tos`), **y** todo el conjunto de datos firmográficos de la empresa (industria, tecnologías, tamaño de plantilla, ingresos, listas guardadas). Aprende los filtros una sola vez en el [Resumen de filtros](/es/developer-guides/filters/overview); los valores válidos están en [Expansion Reference](/es/api-reference/endpoint/expansions/types) y en el catálogo [Cómo funcionan las señales de expansión](/es/knowledge-base/concepts/how-expansion-signals-work).
Autenticación, tus primeras llamadas, paginación y cómo leer las puntuaciones.
Un recorrido completo de mercado a señal.