LinkedIn Search Jobs
La búsqueda de empleos de LinkedIn arma una consulta pública de descubrimiento a partir de una ubicación obligatoria y filtros opcionales. Devuelve registros de ofertas del momento de la recopilación para investigación y para alimentar flujos de trabajo; que una oferta aparezca no prueba que las postulaciones sigan abiertas, y la cantidad de resultados no mide directamente la contratación ni la plantilla de una empresa.
Funcionalidades de la LinkedIn Search Jobs API
- Descubrimiento a partir de la ubicaciónInicie cada consulta con una ubicación no vacía y, de forma opcional, acote la muestra de ofertas públicas con una palabra clave, un país, una empresa u otro filtro del proveedor.
- Filtros flexibles del origenReenvía los valores de time_range, job_type, experience_level, remote, company, location_radius, selective_search y exclusiones sin inventar enumeraciones de SocQ.
- Tope de resultados configurableDefina results_limit de 1 a 2000 para la consulta de descubrimiento única; el valor predeterminado es 100 y el proveedor puede devolver menos registros.
- 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 proveedor.
- Fidelidad al origen con valores nulosMantiene en null los valores no disponibles de salario, trabajo remoto, empresa, experiencia, ubicación, publicación y vencimiento, en lugar de inferirlos.
Parámetros de la LinkedIn Search Jobs API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
location | Obligatorio | Cadena de ubicación obligatoria y no vacía que se usa para armar la consulta de descubrimiento del proveedor. |
keyword | Opcional | Cadena opcional y no vacía con un puesto, una habilidad o un tema, que se reenvía al proveedor. |
country | Opcional | Cadena opcional y no vacía de filtro por país, que se reenvía sin traducción por parte de SocQ. |
time_range | Opcional | Cadena opcional y no vacía, específica del proveedor, de antigüedad o rango de tiempo. |
job_type | Opcional | Cadena opcional y no vacía, específica del proveedor, de filtro por tipo de empleo o de puesto. |
experience_level | Opcional | Cadena opcional y no vacía, específica del proveedor, de filtro por experiencia o nivel de seniority. |
remote | Opcional | Cadena opcional y no vacía, específica del proveedor, de filtro por lugar de trabajo o trabajo remoto. |
company | Opcional | Cadena opcional y no vacía de filtro por empresa, que se reenvía al proveedor. |
selective_search | Opcional | Booleano opcional que se reenvía al proveedor para controlar su comportamiento de búsqueda selectiva. |
jobs_to_not_include | Opcional | Lista opcional de cadenas de exclusión no vacías, que se reenvía al proveedor. |
location_radius | Opcional | Cadena opcional y no vacía, específica del proveedor, con el radio asociado a la consulta de ubicación. |
results_limit | Opcional | Tope entero opcional de esta consulta. El valor predeterminado es 100, el mínimo es 1 y el máximo es 2000. |
Cómo usar la LinkedIn Search Jobs API
Envíe una consulta basada en la ubicación, consulte la tarea asíncrona y procese cada página de resultados devuelta.
- Elija una ubicación, que es obligatoria, y agregue solo valores de filtro del proveedor cuya interpretación haya probado.
- Envíe la consulta por POST a /v1/linkedin/search-jobs y guarde el task_id devuelto.
- 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/search-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location":"Seattle","keyword":"Python","country":"US","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 Search Jobs API
- Descubrimiento de puestos por región: Recopile ofertas públicas para una consulta constante de puesto y ubicación y conserve el momento de la recopilación para comparaciones posteriores.
- Revisión de empleadores y puestos: Inspeccione qué empleadores, títulos, lugares, modalidades de trabajo, niveles de experiencia y tipos de empleo aparecen en la muestra devuelta.
- Disponibilidad de información salarial: Identifique las ofertas que exponen información salarial y conserve la remuneración ausente como un null explícito.
- Ingesta para flujos de empleos: Alimente con las URL y los campos normalizados de ofertas públicas flujos de revisión, deduplicación, alertas o análisis posteriores.
Consejos de expertos para la LinkedIn Search Jobs API
- Pruebe la escritura de los filtros específicos del proveedor en una consulta pequeña antes de usarlos en un flujo de trabajo recurrente.
- Use los mismos filtros y el mismo calendario de recopilación al comparar ubicaciones o fechas.
- Deduplique por el id estable del empleo o por la URL de la oferta, porque las búsquedas renovadas y superpuestas pueden mostrar la misma vacante.
- Trate las etiquetas de trabajo remoto como señales del origen y lea la descripción para detectar restricciones geográficas, de residencia o de zona horaria.
- Mantenga separados published_at, expires_at y collected_at para no confundir la fecha de la oferta con la fecha de obtención.
- Trate los resultados vacíos como un resultado de la recopilación, no como prueba de que no existan empleos públicos coincidentes.
APIs relacionadas
Además de la LinkedIn Search 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 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.