Skip to main content
POST
Buscar ofertas de empleo

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
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[]

Códigos de ubicación ISO 3166-1 alfa-2 (cca2) a excluir de los resultados de empleo. Consulta los endpoints location en la pestaña Filters para ver los códigos válidos.

Ejemplo:
location_ids
integer[]

País de la publicación mediante location_id de Pubrio (endpoint de ubicaciones; también presente en cada fila). Alternativa a locations.

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:
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:
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:
search_term
string

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

Ejemplo:

"pubrio"

search_terms
string[]

Array de cadenas de palabras clave para filtrar ofertas de empleo. Cada término se compara con el contenido de la oferta. Usa search_term para una sola cadena o search_terms para varias palabras clave.

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

Slugs de función derivados del cargo, p. ej. engineering, sales, marketing, finance, product_management; los mismos valores que las filas devuelven en functions. Los slugs desconocidos no coinciden con nada. Lista completa: Enums y constantes.

Ejemplo:
seniority_ranks
enum<integer>[]

Nivel de antigüedad según el cargo: 1 junior, 2 senior, 3 mánager, 4 director, 5 ejecutivo. Los valores fuera del rango 1–5 se ignoran y el filtro se descarta. Las filas devuelven su nivel en seniority_rank (0 = sin clasificar).

Opciones disponibles:
1,
2,
3,
4,
5
Ejemplo:
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:
launch_dates
string<date>[]

Ventana inclusiva [from, to] (UTC) sobre la fecha de publicación: posting_date, o el día de ingesta cuando no está presente. Coincide con la forma en que Job Insights cuenta. Una única fecha coincide con ese día.

Required array length: 1 - 2 elements
Ejemplo:
created_at
string<date-time>

Ingerido en este instante o después (UTC). Fecha o marca de tiempo ISO. Para sincronizaciones incrementales, pasa el created_at de tu registro almacenado más reciente.

Ejemplo:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
predeterminado:false

Activa el enriquecimiento en tiempo real para una única consulta con alcance de empresa (filtrada por domain_search_id, domains o linkedin_urls). Cuando la búsqueda inicial devuelve cero resultados, el endpoint extrae la fuente, persiste los registros y vuelve a ejecutar la búsqueda antes de responder. Sujeto a un límite de tiempo por ruta.

Ejemplo:

true

is_ascending_order
boolean
predeterminado:false

Dirección de ordenación. Los resultados se devuelven por defecto de más reciente a más antiguo; establece true para el orden inverso (de más antiguo a más reciente). No existe sort_by en este endpoint: la clave de ordenación es fija y se indica en la descripción del endpoint.

Ejemplo:

false

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 empleos de empresas.

metadata
object

Contexto de la solicitud.

data
object
Última modificación el 4 de septiembre de 2026