Skip to main content
POST
Expansion Search

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
​
froms
string[]
requerido

Mercados de origen (ISO 3166-1 alfa-2). Desde dónde se expande una empresa: sus países de origen o sede. Úsalo solo para encontrar empresas que crecen a partir de estos mercados; combínalo con tos para un corredor origen→destino específico.

Ejemplo:
​
tos
string[]

Mercados de destino (ISO 3166-1 alfa-2). Hacia dónde se expande una empresa. Úsalo solo para encontrar todas las empresas que están entrando en estos mercados; combínalo con froms para un corredor origen→destino específico.

Ejemplo:
​
exclude_froms
string[]

Mercados de origen a excluir (ISO 3166-1 alfa-2).

Ejemplo:
​
exclude_tos
string[]

Mercados de destino a excluir (ISO 3166-1 alfa-2).

Ejemplo:
​
stages
enum<string>[]

Los valores distinguen mayúsculas de minúsculas y no se validan. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en stages, freshness, scopes y momentum se descarta el filtro completo y obtienes resultados sin filtrar, mientras que en signal_types y signal_strengths el filtro se aplica y no coincide con nada. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde Expansion Reference y compara data.pagination.total_entries con una llamada sin filtrar si un conjunto de resultados parece incorrecto.

Opciones disponibles:
exploring,
committing,
expanding,
scaling
Ejemplo:
​
momentum
enum<string>[]

Trayectoria del movimiento de la empresa en el mercado. advancing indica que está ganando terreno, steady que se mantiene estable, pulling_back cubre la retirada y la contracción.

No uses aquí los valores de directions en Expansion Reference. Esos (advancing, steady, retreating, new) son los valores de respuesta que obtienes en stage.direction; solo los tres indicados arriba se aceptan como filtro. Enviar retreating o new desactiva silenciosamente el filtro y devuelve resultados sin filtrar.

Opciones disponibles:
advancing,
steady,
pulling_back
Ejemplo:
​
freshness
enum<string>[]

Los valores distinguen mayúsculas de minúsculas y no se validan. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en stages, freshness, scopes y momentum se descarta el filtro completo y obtienes resultados sin filtrar, mientras que en signal_types y signal_strengths el filtro se aplica y no coincide con nada. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde Expansion Reference y compara data.pagination.total_entries con una llamada sin filtrar si un conjunto de resultados parece incorrecto.

Opciones disponibles:
fresh,
cooling,
stale,
cold
Ejemplo:
​
scopes
enum<string>[]

Filtra por alcance de entrada al mercado.

Opciones disponibles:
entering_new_market,
expanding_within_presence,
established_only
Ejemplo:
​
ahead_of_pace
boolean

Limita a los pares que avanzan más rápido que el ritmo habitual de ese mercado.

Ejemplo:

false

​
signal_types
enum<string>[]

Los valores distinguen mayúsculas de minúsculas y no se validan. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en stages, freshness, scopes y momentum se descarta el filtro completo y obtienes resultados sin filtrar, mientras que en signal_types y signal_strengths el filtro se aplica y no coincide con nada. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde Expansion Reference y compara data.pagination.total_entries con una llamada sin filtrar si un conjunto de resultados parece incorrecto.

Opciones disponibles:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Ejemplo:
​
signal_strengths
enum<string>[]

Los valores distinguen mayúsculas de minúsculas y no se validan. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en stages, freshness, scopes y momentum se descarta el filtro completo y obtienes resultados sin filtrar, mientras que en signal_types y signal_strengths el filtro se aplica y no coincide con nada. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde Expansion Reference y compara data.pagination.total_entries con una llamada sin filtrar si un conjunto de resultados parece incorrecto.

Opciones disponibles:
low,
medium,
high,
very_high
Ejemplo:
​
min_signal_count
integer

Número mínimo de señales de expansión que debe tener una empresa en la ventana de tiempo — "muy activa / presencia intensa".

Ejemplo:

3

​
only_contraction
boolean

Cuando es true, devuelve solo las expansiones marcadas como contracción (empresas que están reduciendo su actividad).

Ejemplo:

false

​
min_markets
integer

Número mínimo de mercados nuevos en los que debe haber entrado una empresa dentro de la ventana de tiempo.

Ejemplo:

3

​
home_country_code
string[]

Filtra por país de origen de la empresa (ISO 3166-1 alfa-2). Se combina con froms cuando se proporcionan ambos.

Ejemplo:
​
industries
string[]

Filtra por nombre de industria (coincidencia de texto libre).

Ejemplo:
​
exclude_industries
string[]

Industrias a excluir (coincidencia de texto libre).

Ejemplo:
​
verticals
integer[]

Una lista de vertical_id utilizada para buscar empresas en un vertical o industria específica. Para encontrar el ID, llama al endpoint vertical en la pestaña Filters.

Este filtro admite is_enable_similarity_search; una vez habilitado, puedes introducir texto libre, por ejemplo ["AI"].

​
vertical_categories
integer[]

Una lista de vertical_category_id utilizada para buscar empresas en una categoría vertical específica. Para encontrar el ID, llama al endpoint vertical category en la pestaña Filters.

Este filtro admite is_enable_similarity_search; una vez habilitado, puedes introducir texto libre, por ejemplo ["Information Technology"].

​
vertical_sub_categories
integer[]

Una lista de vertical_sub_category_id utilizada para buscar empresas en una subcategoría vertical específica. Para encontrar el ID, llama al endpoint vertical sub category en la pestaña Filters.

Este filtro admite is_enable_similarity_search; una vez habilitado, puedes introducir texto libre, por ejemplo ["Software"].

​
technologies
integer[]

Una lista de tag_id utilizada para buscar tecnologías específicas usadas por las empresas. Para encontrar el ID, llama al endpoint technology en la pestaña Filters.

Este filtro admite is_enable_similarity_search; una vez habilitado, puedes introducir texto libre, por ejemplo ["Shopify"].

​
employees
string[][]

El rango numérico de empleados que trabajan en la empresa. Esto te permite encontrar empresas según su plantilla. Puedes añadir varios rangos para ampliar los resultados de búsqueda.

Consulta los endpoints company size en la pestaña Filters para más información.

Ejemplo:
​
revenues
integer[]

Rango mínimo y máximo de ingresos de la empresa.

Ejemplo:
​
founded_dates
integer[]

Rango de años de fundación de la empresa. El valor máximo de fundación es el año en curso.

Ejemplo:
​
keywords
string[]

Una lista de palabras clave para filtrar empresas por relevancia, especialidades o descripciones.

Ejemplo:
​
companies
string[]

Limita el alcance a empresas específicas mediante cualquier combinación de domain_search_id, dominio de la empresa o URL de perfil de red social de la empresa. Los dominios y las URL se resuelven a la empresa mejor clasificada.

Ejemplo:
​
job_locations
string[]

Se usa el código ISO 3166-1 alfa-2 (cca2) para filtrar ubicaciones. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:
​
job_exclude_locations
string[]

Ubicaciones geográficas a excluir de los resultados de ofertas de empleo.

Ejemplo:
​
job_posted_dates
string[]

Rango de fechas de publicación. El valor máximo es el día actual. Los límites del día siguen la zona horaria de tu espacio de trabajo.

Ejemplo:
​
job_titles
string[]

Cargos asociados a las personas que deseas localizar.

Los resultados también incluirán cargos que contengan terminología similar, aunque no coincidan exactamente. Por ejemplo, buscar software engineer puede devolver resultados de personas con el cargo senior software engineer.

Ejemplo:
​
advertisement_target_locations
string[]

Ubicaciones geográficas objetivo para los anuncios.

Ejemplo:
​
advertisement_exclude_target_locations
string[]

Ubicaciones geográficas a excluir de la segmentación de anuncios.

Ejemplo:
​
advertisement_search_terms
string[]

Palabras clave utilizadas para buscar dentro del contenido o los títulos de los anuncios.

Ejemplo:
​
advertisement_start_dates
string<date>[]

Rango de fecha de inicio para filtrar anuncios.

Ejemplo:
​
advertisement_end_dates
string<date>[]

Rango de fecha de fin para filtrar anuncios.

Ejemplo:
​
news_categories
string[]

Lista de category slugs para buscar categorías de noticias específicas. Para encontrar un slug, llama al endpoint news categories en la pestaña Filters.

Ejemplo:
​
news_published_dates
string[]

Rango de fechas de publicación. El valor máximo es el día actual. Los límites del día siguen la zona horaria de tu espacio de trabajo.

Ejemplo:
​
transitioned_dates
string<date>[]

Rango de fechas ISO para la ventana de la línea temporal. El valor predeterminado son los últimos 90 días. Una query en lenguaje natural también puede definir esto a partir de frases de calendario ("this year", "last year", "Q2 2026").

Ejemplo:
​
window_days
integer

Opcional. Tamaño de la ventana móvil en días. Se usa cuando no se proporciona un rango explícito de transitioned_dates; si se omiten ambos, se usa una ventana predeterminada.

Ejemplo:

90

​
query
string

Consulta en lenguaje natural que Pubrio interpreta como filtros de expansión y de empresa.

Ejemplo:

"fintech companies expanding into the UK"

​
is_explain_match
boolean

Incluye explicaciones generadas por IA sobre por qué cada empresa coincide con la búsqueda, basadas en las señales reales de la empresa. Funciona mejor combinado con una consulta en lenguaje natural. Tanto el número de señales citadas como el tamaño del lote escalan con per_page; las fuentes de alto volumen (ofertas de empleo, campañas publicitarias) se resumen como un recuento acotado a la ventana de tiempo (por ejemplo, "12 job postings") en lugar de enumerarse individualmente.

Ejemplo:

true

​
sort_by
enum<string>

Orden de los resultados. Omítelo para el orden de relevancia predeterminado: primero los pares corroborados (2 o más tipos de señal distintos), luego los pares con evidencia repetida (3 o más señales), y después el resto — dentro de cada nivel, primero los transicionados más recientemente. recent — orden puramente cronológico (los transicionados más recientemente primero). expansion_score — primero la puntuación de expansión más alta. signal_count — primero el par con más señales. company_ranking — clasificación general de empresas de Pubrio (un valor más bajo indica mayor relevancia), ascendente.

Opciones disponibles:
recent,
expansion_score,
signal_count,
company_ranking
Ejemplo:

"expansion_score"

​
is_include_metadata
boolean

Devuelve la carga completa de detalles. El tráfico con clave de API es reducido de forma predeterminada: el bloque model, las cifras de confianza (stage.confidence en Company Expansion Detail, confidence_score en other_markets[] y en los markers[] de Rankings) y los campos established_min / share_of_detected / has_known_office se omiten a menos que esto sea true.

Ejemplo:

true

​
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_enable_similarity_search
boolean

Habilita la coincidencia de texto libre para verticals, vertical_categories, vertical_sub_categories y technologies; estos filtros se descartan a menos que esto sea true.

Ejemplo:

true

Respuesta

Lista paginada de empresas que se están expandiendo en el/los mercado(s). filters refleja los criterios aplicados (o interpretados a partir del lenguaje natural); cada empresa incluye un match_summary cuando is_explain_match es true.

​
metadata
object

Metadatos de la búsqueda: los filtros realmente aplicados, además del resumen del mercado (agregado, alcance geográfico, principales orígenes/destinos/industrias, línea temporal). Las respuestas con clave de API incluyen el resumen solo cuando is_include_metadata es true.

​
data
object

Contenedor de resultados (envoltorio estándar de búsqueda): la lista de empresas más la paginación.

Última modificación el 4 de septiembre de 2026