Skip to main content
POST
Detalle de expansión de empresa

Autorizaciones

pubrio-api-key
string
header
requerido

Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.

Cuerpo

application/json
domain_search_id
string<uuid>
requerido

Identificador único para la operación de búsqueda de empresas.

country_code
string

Mercado objetivo como código de país ISO 3166-1 alfa-2 (cca2). Omítelo para seleccionar automáticamente el mercado más activo de la empresa; establece is_all_markets para una vista de todos los mercados.

Ejemplo:

"US"

is_all_markets
boolean

Devuelve la huella de expansión completa de la empresa en TODOS los mercados en una sola llamada, en lugar de un único mercado. Cuando es true, se ignora country_code, el mercado de origen se excluye de los agregados de señales cuando puede identificarse, data se convierte en un resumen a nivel de empresa (etapa dominante, total de señales, rango de fechas, puntuación de expansión más alta), y markets_summary enumera todos los mercados. Por defecto es false.

Ejemplo:

false

signal_type
enum<string>

Filtra las señales devueltas a un solo tipo.

Opciones disponibles:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Ejemplo:

"EXEC"

query
string

Descripción en lenguaje sencillo de lo que vendes, o el perfil de comprador con el que estás evaluando esta empresa. Se usa únicamente para fundamentar el summary de IA (consulta is_explain_match); a diferencia de la búsqueda de empresas, aquí NO se interpreta como filtros.

Ejemplo:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

Cuando es true y se proporciona un query, summary devuelve un único resumen de IA sobre la actividad de expansión de esta empresa dentro del alcance actual (el mercado seleccionado, o todos los mercados extranjeros cuando is_all_markets es true), interpretado en función de tu query y fundamentado en las señales reales de la empresa con citas [n].

Ejemplo:

true

window_days
integer
predeterminado:90

Opcional. Ventana móvil (en días) que acota el feed del summary de IA. Por defecto es 90 cuando no se proporciona ni este parámetro ni transitioned_dates. No afecta a la lista paginada de signals (historial completo).

Ejemplo:

90

transitioned_dates
string<date>[]

Rango de fechas ISO [from, to] para la ventana de señales/transiciones. Tiene prioridad sobre window_days cuando se proporcionan ambos.

Ejemplo:
domain
string

Un dominio de empresa utilizado para operaciones de búsqueda de empresas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.

Ejemplo:

"pubrio.com"

linkedin_url
string

La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por http y contener linkedin.com/company/

Ejemplo:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

Incluye la etapa established (operadores consolidados sin señales de expansión activas). Por defecto es false.

Ejemplo:

false

page
integer
predeterminado:1

Número de página, empezando en 1. El límite es el max_search_page de tu suscripción (max_company_search_page para la búsqueda de empresas), devuelto por Perfil. Superarlo devuelve HTTP 416.

Ejemplo:

1

per_page
integer
predeterminado:25

Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el max_search_per_page de tu suscripción, devuelto por Perfil. Superarlo devuelve HTTP 416 con el código 41676 (o 41613 en la búsqueda de empresas y personas), no un conjunto de resultados recortado.

Rango requerido: x <= 25
Ejemplo:

25

is_include_metadata
boolean

Devuelve la carga útil de detalle completa. El tráfico con clave de API es ligero por defecto: el bloque model, las cifras de confianza (stage.confidence en Company Expansion Detail, confidence_score en other_markets[] y en markers[] de Rankings) y los campos established_min / share_of_detected / has_known_office se omiten todos a menos que este sea true.

Ejemplo:

true

summary_only
boolean

Devuelve únicamente el bloque de resumen de etapa (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) y omite la lista de señales y sus agregados. Mucho más económico para vistas de tipo hero/encabezado.

Ejemplo:

true

markets_summary_full
boolean

Incluye el conjunto completo de mercados clasificados como markets_summary, junto con la lista limitada other_markets.

Ejemplo:

true

Respuesta

Detalle de empresa en el mercado.

metadata
object
data
object

Contenedor de resultados.

signals
object[]

Las filas de señales paginadas detrás de este par empresa/mercado: la lista de evidencia. El tamaño de página y los totales provienen de metadata.pagination.

summary
object

Resumen de una línea de la etapa para el par. Solo en la primera página.

company
object

Datos identificativos de la empresa: nombre, dominio, logotipo y URLs sociales. Solo en la primera página.

signal_group_totals
object[]

Recuento de señales por tipo, agrupado por día en tu zona horaria. Solo en la primera página.

signal_type_totals
object[]

Totales históricos de señales por tipo de señal. Solo en la primera página.

signal_type_recent_totals
object[]

Totales de señales por tipo durante las últimas 12 semanas. Solo en la primera página.

signal_weekly_totals
object[]

Recuento semanal de señales para el mapa de calor, misma ventana que signal_type_recent_totals. Solo en la primera página.

evidence_breakdown
object

Resumen de evidencia por tipo de fuente, calculado a partir de las señales devueltas (redactadas). Solo en la primera página.

presence
object

Presencia física y digital observada de la empresa en este mercado. Solo en la primera página.

suppressions
object[]

Señales excluidas del cálculo de la etapa, con el motivo de cada una. Solo en la primera página.

timeline
object[]

Historial de transición de etapas para este par empresa/mercado. Solo en la primera página.

other_markets
object[]

Los otros mercados activos de la empresa. Limitado en planes con restricciones; consulta other_markets_locked_count. Solo en la primera página.

other_markets_locked_count
integer

Cuántos mercados adicionales no devolvió tu plan en other_markets. 0 cuando no se omitió ninguno.

markets_summary
object[]

Conjunto completo de mercados clasificados para esta empresa. Se devuelve únicamente cuando markets_summary_full es true, en la primera página.

Última modificación el 4 de septiembre de 2026