¿Eres nuevo en los conceptos (etapas, señales, momentum, actualidad)? Empieza con ¿Qué son las señales de expansión? — esta guía asume que ya los conoces y se centra en la selección de endpoints.
Elige según la tarea
Los endpoints de un vistazo
Expansion Search
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.Expansion Overview
Agregados a nivel de mercado: conteos por etapa, principales flujos transfronterizos, actividad de empresas vigiladas. Sin paginación — una instantánea de dashboard.
Company Expansion Detail
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.
Company Signal Events
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.
Compare Company Expansions
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.
Batch Company Expansion Summaries
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.
Expansion Rankings
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.
Expansion Signal Search
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:”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, mostrado como una cuadrícula — mercados, impulso, puntuación de expansión y las principales incorporaciones, en paralelo.
Un flujo de trabajo típico
Descubrir
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”.Profundizar en una empresa
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.Ver el feed de actividad (opcional)
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.
Comparar o graficar
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; los valores válidos están en Expansion Reference y en el catálogo Cómo funcionan las señales de expansión.
Usar la API de Expansion
Autenticación, tus primeras llamadas, paginación y cómo leer las puntuaciones.
Ejemplo resuelto
Un recorrido completo de mercado a señal.