Skip to main content
POST
Buscar personas similares

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
peoples
string<uuid>[]
requerido

Una lista de identificadores únicos (people_search_id) utilizada para operaciones de búsqueda de personas.

people_search_id
string

ID de persona de Pubrio a usar como referencia.

linkedin_url
string

Una única URL de perfil de LinkedIn a usar como referencia.

identifier
string

Una cadena de referencia libre (nombre, cargo o URL de perfil) para iniciar la búsqueda por similitud.

search_term
string

Una cadena de palabras sobre la que queremos filtrar los resultados.

Ejemplo:

"pubrio"

people_name
string

Filtra los resultados de búsqueda para incluir un nombre de persona específico.

Ejemplo:

"king"

people_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:
management_levels
enum<string>[]

Nivel jerárquico de la persona. El slug para la alta dirección es c_suite, no c_level. Los slugs desconocidos se descartan cuando hay otros filtros de personas presentes, y fallan con 40037 cuando este es el único filtro. Lista completa en el endpoint management level de la pestaña Filters.

Opciones disponibles:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
Ejemplo:
departments
string[]

El campo de departamento permite buscar personas en áreas de especialización específicas.

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

Ejemplo:
department_functions
string[]

El campo de filtro para funciones laborales permite especificar roles o áreas de especialización concretas al buscar personas.

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

Ejemplo:
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:
people_locations
string[]

La ubicación donde viven las personas. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:
company_locations
string[]

La ubicación de la sede de la empresa. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:
company_linkedin_urls
string[]

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

Ejemplo:
linkedin_urls
string[]

La URL completa del perfil de LinkedIn del usuario. La URL debe empezar por http y contener linkedin.com/in/ o linkedin.com/pub/

Ejemplo:
companies
string<uuid>[]

Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas.

domains
string[]

Lista de dominios de empresa utilizada para operaciones de búsqueda de empresas y personas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.

Ejemplo:
filter_conditions
object[]

Anulación de AND/OR por clave para los filtros en /people/search. Por defecto es OR cuando se omite. Consulta la guía para desarrolladores de filtros de personas y empresas para la referencia completa de reasignación de claves.

Cuando está habilitado, los filtros indicados anteriormente que admiten búsquedas por similitud pueden completarse con texto libre en lugar de IDs específicos.

similarity_score
number<float>

Se usa junto con is_enable_similarity_search. Este número se utiliza para analizar si un slug específico (por ejemplo, vertical de industria, tecnología) es similar a la entrada del usuario, y cuanto mayor es el número, más estricto es.

Ejemplo:

0.7

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

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

company_filters
object

Objeto contenedor para filtros a nivel de empresa. Agrupación recomendada que separa visualmente qué claves filtran a la persona (nivel superior) de cuáles filtran a la empresa. Acepta las mismas claves que los filtros de empresa de nivel superior (por ejemplo, technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, además de filter_conditions). El motor aplana este objeto al nivel superior antes de procesarlo — las claves de nivel superior prevalecen en caso de conflicto. Misma estructura que usa company_filters en Monitor. Consulta la guía para desarrolladores sobre filtros para ver ejemplos.

Ejemplo:

Respuesta

Respuesta exitosa que contiene los detalles de la búsqueda de personas.

metadata
object

Contexto de la solicitud — filters y parameters reflejados, además de un bloque profile con credit, topup_credit y total_credit_cost cuando se solicita el cálculo de créditos.

data
object | null

La información de la respuesta depende del endpoint específico.

Última modificación el 4 de septiembre de 2026