LinkedIn Jobs
Una oferta de empleo pública de LinkedIn describe una vacante concreta mediante su puesto, empleador, descripción, ubicación, nivel de seniority, tipo de empleo, sector, vía de postulación y la remuneración publicada, si la hay. Estos detalles sirven para dar seguimiento a vacantes, comparar puestos, investigar el reclutamiento y armar catálogos de empleos estructurados.
Funcionalidades de la LinkedIn Jobs API
- Entrada por URL de detalle del empleoProcesa una o más páginas públicas /jobs/view/{slug} de LinkedIn y rechaza los resultados de búsqueda y las URL de colecciones de empleos.
- Puesto y empleador en un solo registroDevuelve juntos el título del empleo, la descripción completa, la URL de la oferta y la identidad pública normalizada de la empresa que contrata.
- Atributos de empleo estructuradosExpone la ubicación, el nivel de seniority, el tipo de empleo y los sectores como campos separados, en lugar de dejarlos dentro de la descripción.
- Campos de postulación y remuneraciónDevuelve apply_link, la señal de Easy Apply, el salario, la hora de publicación y la hora de recopilación como campos separados de la oferta.
Parámetros de la LinkedIn Jobs API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de detalle de empleos de LinkedIn. Cada URL debe usar la ruta /jobs/view/{slug} en linkedin.com o en un subdominio de LinkedIn. |
Cómo usar la LinkedIn Jobs API
Envíe enlaces conocidos de detalle de empleos, espere a que se preparen los registros de contratación y obtenga todas las páginas de resultados disponibles.
- Filtre la lista de entrada para conservar solo los enlaces públicos de detalle /jobs/view/{slug}.
- Envíe esos enlaces en urls por POST a /v1/linkedin/jobs y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que la tarea de empleos llegue a un estado final.
- Tras el éxito, procese data.results.items y use next_cursor en cada página marcada por has_more.
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la LinkedIn Jobs API
- Seguimiento de vacantes: Use el puesto, el empleador, la ubicación, la hora de publicación y la URL de origen para mantener una lista estructurada de vacantes conocidas.
- Comparación de puestos y requisitos: Compare las descripciones, el nivel de seniority, el tipo de empleo, el sector, la ubicación y el salario disponible entre las ofertas seleccionadas.
- Investigación del mercado de reclutamiento: Agrupe las vacantes seleccionadas por empleador, ubicación, sector o tipo de empleo para estudiar los patrones de contratación visibles.
- Gestión de las vías de postulación: Use apply_link y la señal de Easy Apply para dirigir cada oferta guardada a su vía de postulación disponible.
Consejos de expertos para la LinkedIn Jobs API
- Extraiga y deduplique el identificador del empleo a partir de los enlaces /jobs/view/ para que las formas alternativas de URL no generen ofertas repetidas.
- Trate salary como un dato de origen opcional, porque muchas ofertas lo omiten y los valores expuestos pueden no compartir un mismo formato.
- Valide apply_link antes de presentarlo como una acción de salida en una interfaz posterior.
- Mantenga separados created_at y collected_at para no confundir la hora de publicación con la hora en que se obtuvo la oferta.
APIs relacionadas
Además de la LinkedIn Jobs API, use estas APIs cuando necesite otro tipo de datos públicos de LinkedIn.
- LinkedIn Profiles API — Normaliza desde URLs de perfiles la identidad del perfil público, los cargos, la ubicación, los conteos visibles de audiencia, la experiencia, la formación y las habilidades.
- LinkedIn Companies API — Normaliza descripciones públicas de empresas, sitios web, logotipos, conteos visibles de audiencia y de empleados, sectores, ubicaciones y especialidades.
- LinkedIn Posts API — Recolecta desde URLs compatibles el texto de publicaciones públicas, autores, interacción visible, contenido multimedia, hora de publicación, tipo y hashtags.
- LinkedIn Company Jobs API — Descubre ofertas de empleo públicas desde URLs /jobs/ de LinkedIn preparadas, con campos normalizados de puesto, empresa, ubicación, tipo de empleo, experiencia, trabajo remoto, salario y fechas.
- LinkedIn Company Posts API — Descubre publicaciones públicas desde URLs de páginas de empresas de LinkedIn, con texto, contexto del autor, contenido multimedia, hashtags, marcas de tiempo e interacción visible.
- LinkedIn Search Jobs API — Busca empleos públicos de LinkedIn a partir de una ubicación obligatoria y filtros opcionales, y devuelve campos normalizados de puesto, empresa, lugar, tipo de empleo, experiencia, trabajo remoto, salario y fechas.