Esta guía rápida te lleva de cero a leer señales de expansión en vivo en unas pocas llamadas. Se asume que ya tienes una clave de API de Pubrio — consulta Autenticación para crear una.
Requisitos previos
- Una clave de API de Pubrio (consulta Autenticación).
- El
domain_search_idde una empresa. Puedes obtenerlo desde el endpoint de búsqueda de empresas.
POST y aceptan un cuerpo JSON. Incluye tus credenciales en cada solicitud tal como se describe en Autenticación.
Paso 1 — Consultar la expansión de una empresa
Empieza con una sola empresa y lista todos los mercados en los que se está expandiendo.Paso 2 — Leer el resultado
Cada entrada enmarkets_summary describe un mercado en el que la empresa está activa:
stage_slug— hasta dónde ha avanzado la empresa en ese mercado (exploring→scaling).signal_count/distinct_type_count— cuánta evidencia respalda el mercado, en cuántos tipos de señal.latest_signal_at— la antigüedad de la señal más reciente.signal_velocity_30d/signal_velocity_90d— con qué rapidez está aumentando la actividad.rank_now— la posición actual del mercado para esta empresa (1= la más fuerte).is_home_market— si este es el país de la sede de la empresa.
freshness, momentum) que se muestran a continuación.
Paso 3 — Explorar un mercado completo
Para trabajar primero por mercado en lugar de por empresa, usa Detalle de expansión de mercado. Está paginado con los parámetros estándarpage / per_page.
La geografía es una relación dirigida de → a, expresada con dos listas: froms (mercados de origen / sede) y tos (mercados objetivo). Elige el patrón que coincida con tu pregunta:
metadata.pagination para paginar los resultados:
page. per_page está limitado por tu plan — solicitar explícitamente más de tu límite devuelve un error en lugar de truncar silenciosamente.
Dos valores predeterminados que conviene conocer:
- Orden — los resultados llegan en orden de relevancia (primero las empresas corroboradas por varios tipos de señal, luego las más recientes). Pasa
sort_by: "recent"para orden puramente cronológico, oexpansion_score/signal_count/company_ranking. - Respuestas ligeras — las respuestas con clave de API omiten por defecto el resumen del mercado (
metadata.aggregate, principales orígenes/destinos, línea temporal) y el detalle del modelo. Pasais_include_metadata: truecuando los necesites.
Paso 4 — Profundizar en la evidencia
Cuando quieras las señales individuales detrás del movimiento de una empresa, llama a Eventos de señales de la empresa.total_entries y total_pages — solicita las páginas de la 1 a total_pages (es decir, continúa mientras page < total_pages).
Referencia de filtros
La mayoría de los endpoints de expansión aceptan estos filtros. Sus valores válidos se detallan en Cómo funcionan las señales de expansión:
El filtro
companies acepta cualquier combinación de tipos de identificador — no es necesario resolverlos primero a IDs:
Próximos pasos
Ejemplo resuelto
El recorrido completo de mercado a señal.
Endpoints de expansión
Explora todos los endpoints de la API de expansión.