LinkedIn Company Jobs
Los empleos de empresas en LinkedIn son ofertas públicas con título, empresa, ubicación, tipo de empleo, nivel de experiencia, modalidad remota, salario y datos de fechas. Estos campos sirven para dar seguimiento a empleos, comparar puestos, investigar la contratación y armar directorios de empleos estructurados.
Funcionalidades de la LinkedIn Company Jobs API
- Descubrimiento en páginas de empleosEnvíe una o más URL públicas de LinkedIn cuyas rutas comiencen con /jobs/ y recopile las ofertas que muestra cada página preparada.
- Límite por entradaDefina results_limit de 1 a 2000; el tope elegido se aplica de forma independiente a cada URL de la solicitud.
- Registros de empleo canónicosReciba campos estables de empleo, empresa, ubicación, salario, publicación, vencimiento y recopilación en lugar de anidaciones específicas del origen.
- Fidelidad al origen con valores nulosMantiene los campos en null cuando una oferta no expone públicamente valores como el salario, la modalidad remota, el nivel de experiencia o la ubicación exacta.
Parámetros de la LinkedIn Company Jobs API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de LinkedIn con http o https. El host de cada una debe ser linkedin.com o un subdominio de LinkedIn, y cada ruta debe comenzar con /jobs/. |
results_limit | Opcional | Tope entero opcional de resultados que se aplica a cada URL de entrada. El valor predeterminado es 100, el mínimo es 1 y el máximo es 2000. |
Cómo usar la LinkedIn Company Jobs API
Envíe URL de páginas de empleos preparadas, consulte la tarea asíncrona y procese cada página de resultados devuelta.
- Prepare URL públicas de LinkedIn cuya ruta comience con /jobs/ y conserve los parámetros de consulta que resulten útiles.
- Envíe urls y results_limit por POST a /v1/linkedin/company-jobs y guarde el task_id.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a un estado final.
- Tras el éxito, procese data.results.items y siga next_cursor siempre que has_more sea true.
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la LinkedIn Company Jobs API
- Monitoreo de empleadores seleccionados: Vuelva a consultar URL de empleos preparadas y orientadas a empresas y compare las ofertas públicas devueltas en distintos momentos de recopilación.
- Enriquecimiento de catálogos de puestos: Agregue campos normalizados de empresa, ubicación, tipo de empleo, experiencia, modalidad remota, salario y fechas a un catálogo público de empleos.
- Investigación de páginas de contratación: Compare la mezcla de puestos devuelta en las páginas de empleos seleccionadas, conservando cada URL de origen y cada marca de tiempo de recopilación.
- Ingesta para flujos de trabajo: Alimente con los registros de ofertas públicas descubiertas flujos de revisión, deduplicación, alertas o análisis posteriores.
Consejos de expertos para la LinkedIn Company Jobs API
- Conserve en las URL preparadas los parámetros de consulta relevantes, porque pueden influir en las ofertas que expone la página.
- Deduplique por el id estable del empleo o por la URL de la oferta cuando páginas de empleos que se superponen devuelvan la misma vacante.
- Trate un resultado vacío de una URL como un resultado de la recopilación, no como prueba de que un empleador no tenga puestos abiertos.
- Use la búsqueda de empleos estructurada cuando necesite controles explícitos de palabra clave o ubicación en lugar de URL de páginas preparadas.
- Mantenga separados published_at, expires_at y collected_at para no confundir la fecha de la oferta con la fecha de obtención.
APIs relacionadas
Además de la LinkedIn Company 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 Jobs API — Normaliza títulos de empleos públicos, empresas, descripciones, ubicaciones, requisitos, datos del tipo de empleo, enlaces para postularse y campos de salario disponibles.
- 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.