linkedin/
search-jobs

Busque ofertas de empleo públicas de LinkedIn por ubicación y filtros opcionales del proveedor, con campos normalizados de puesto, empresa, lugar, tipo de empleo, experiencia, trabajo remoto, salario y fechas.

LinkedIn Search Jobs API

Ubicación obligatoria
Descubrimiento estructurado
Registros de empleo canónicos
0.5 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 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ámetrosObligatorioDescripción
locationObligatorioCadena de ubicación obligatoria y no vacía que se usa para armar la consulta de descubrimiento del proveedor.
keywordOpcionalCadena opcional y no vacía con un puesto, una habilidad o un tema, que se reenvía al proveedor.
countryOpcionalCadena opcional y no vacía de filtro por país, que se reenvía sin traducción por parte de SocQ.
time_rangeOpcionalCadena opcional y no vacía, específica del proveedor, de antigüedad o rango de tiempo.
job_typeOpcionalCadena opcional y no vacía, específica del proveedor, de filtro por tipo de empleo o de puesto.
experience_levelOpcionalCadena opcional y no vacía, específica del proveedor, de filtro por experiencia o nivel de seniority.
remoteOpcionalCadena opcional y no vacía, específica del proveedor, de filtro por lugar de trabajo o trabajo remoto.
companyOpcionalCadena opcional y no vacía de filtro por empresa, que se reenvía al proveedor.
selective_searchOpcionalBooleano opcional que se reenvía al proveedor para controlar su comportamiento de búsqueda selectiva.
jobs_to_not_includeOpcionalLista opcional de cadenas de exclusión no vacías, que se reenvía al proveedor.
location_radiusOpcionalCadena opcional y no vacía, específica del proveedor, con el radio asociado a la consulta de ubicación.
results_limitOpcionalTope 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.

  1. Elija una ubicación, que es obligatoria, y agregue solo valores de filtro del proveedor cuya interpretación haya probado.
  2. Envíe la consulta por POST a /v1/linkedin/search-jobs y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a un estado final.
  4. 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 true

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

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.

Explorar otras plataformas

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

LinkedIn Search Jobs API — FAQ

LinkedIn Search Jobs API es una interfaz programática que descubre ofertas de empleo públicas de LinkedIn a partir de una ubicación obligatoria y filtros opcionales del proveedor. Devuelve campos normalizados de puesto, empresa, ubicación, tipo de empleo, experiencia, trabajo remoto, salario y fechas de las ofertas disponibles en el momento de la recopilación.

location es obligatorio y debe contener una cadena no vacía. Proporcionar solo una palabra clave, una empresa u otro filtro opcional no satisface el validador actual.

No. SocQ reenvía las cadenas de filtro no vacías al proveedor de descubrimiento sin definir ni traducir sus escrituras y combinaciones aceptadas.

No. Es un tope entero de 1 a 2000, con un valor predeterminado de 100. La disponibilidad pública, las combinaciones de filtros, la paginación, los duplicados y el comportamiento del proveedor pueden producir menos registros.

No. Cada resultado es un registro público del momento de la recopilación. Verifique en la oferta el estado de la postulación, las responsabilidades, las restricciones de ubicación y la remuneración antes de actuar.

No. El endpoint no postula, no guarda empleos, no crea alertas, no obtiene postulantes, no accede a Recruiter ni ofrece puntuaciones de afinidad personalizadas.

Cada registro de empleo devuelto cuesta 0.5 créditos de SocQ, sin cargo base. La estimación predeterminada es de 100 resultados, los conjuntos de resultados vacíos no generan cargo por resultado y el uso real puede superar la estimación cuando se permite.