Skip to main content
POST
Buscar empresas afines

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.

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

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

Ejemplo:
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"].

categories
integer[]

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

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

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"].

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"

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:
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:
revenues
integer[]

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

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_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:
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:

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

Respuesta

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

metadata
object

Contexto de la solicitud. Incluye filters y parameters reflejados, y un bloque profile con credit, topup_credit y total_credit_cost — el único cálculo de créditos por llamada que devuelve la API.

data
object | null

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

Última modificación el 4 de septiembre de 2026