linkedin/
jobs

Obtenga empleos públicos de LinkedIn a partir de URL /jobs/view/{slug}, con contexto normalizado del puesto y del empleador, condiciones de empleo, opciones de postulación, remuneración y marcas de tiempo.

LinkedIn Jobs API

Entrada por URL de empleo
Contexto del puesto
Campos de postulación
0.8 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. Filtre la lista de entrada para conservar solo los enlaces públicos de detalle /jobs/view/{slug}.
  2. Envíe esos enlaces en urls por POST a /v1/linkedin/jobs y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea de empleos llegue a un estado final.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de LinkedIn con datos públicos de otras plataformas sociales compatibles.

LinkedIn Jobs API — FAQ

LinkedIn Jobs API obtiene datos públicos de empleos de una o más URL /jobs/view/{slug} aceptadas. Devuelve el puesto, el empleador, la descripción, la ubicación, el nivel de seniority, el tipo de empleo, los sectores, los campos de postulación, el salario disponible y las marcas de tiempo.

No. Cada entrada debe ser una URL completa de LinkedIn con http o https de una sola página de detalle /jobs/view/{slug}; las rutas de búsqueda y de colecciones no superan la validación.

No. Este producto resuelve únicamente las URL públicas de detalle de empleos enviadas en urls y no realiza una búsqueda de empleos de LinkedIn.

Un registro de empleo puede incluir un apply_link externo y una señal is_easy_apply cuando la oferta pública los expone. El endpoint devuelve información de postulación, pero no envía postulaciones.

Puede ser que la oferta pública no publique un salario, un enlace de postulación externo ni la señal de Easy Apply, por lo que esos campos opcionales pueden ser null o estar vacíos.

Los registros de empleo devueltos se facturan a 0.8 créditos de SocQ cada uno. No se aplica cargo por resultado cuando la tarea produce un conjunto de resultados vacío.