LinkedIn Search People
La búsqueda de personas de LinkedIn convierte el valor keywords de cada URL de búsqueda de personas enviada en una consulta al proveedor orientada al nombre. Los resultados son perfiles públicos candidatos para revisar la identidad, no una prueba de que un perfil pertenezca a la persona buscada, y el endpoint no reproduce los filtros de empresa, escuela, ubicación, sector ni conexiones codificados en la URL.
Funcionalidades de la LinkedIn Search People API
- Entrada por URL de búsqueda de personasEnvíe una o más URL públicas de LinkedIn cuyas rutas comiencen con /search/results/people.
- Asignación explícita del nombreDecodifica keywords, asigna su primer token delimitado por espacios a first_name y une los tokens restantes como last_name.
- Descubrimiento de perfiles candidatosReciba URL de perfiles públicos y contexto de identidad que pueden apoyar una coincidencia manual o una recopilación posterior específica de cada perfil.
- Registros de cuenta canónicosDevuelve campos estables de identidad, descripción, imagen, sitio web, estado de la cuenta, ubicación, métricas y recopilación.
- Fidelidad al origen con valores nulosDeja en null los campos no disponibles y evita inferir datos de contacto privados, historial laboral, formación, habilidades o certeza de identidad.
Parámetros de la LinkedIn Search People 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 /search/results/people. Incluya keywords para obtener un comportamiento confiable orientado al nombre. |
Cómo usar la LinkedIn Search People API
Prepare URL de búsqueda de personas orientadas al nombre, envíe la tarea asíncrona y revise cada candidato devuelto.
- Cree una URL de búsqueda de personas de LinkedIn con un valor de consulta keywords que contenga el nombre de la persona.
- Envíe urls por POST a /v1/linkedin/search-people 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-people" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'
# 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 People API
- Descubrimiento de URL de perfiles: Encuentre URL de perfiles públicos candidatos de LinkedIn antes de usar un endpoint de recopilación específico de cada perfil.
- Resolución manual de identidad: Compare nombres, descripciones, ubicaciones, imágenes y URL entre los candidatos, conservando la incertidumbre.
- Ingesta para directorios públicos: Alimente una cola de revisión con cuentas candidatas normalizadas, sin prometer enriquecimiento de contactos ni atributos privados.
- Investigación de variantes de nombres: Ejecute por separado grafías de nombres elegidas con cuidado y compare los candidatos públicos que se produjeron en cada momento de recopilación.
Consejos de expertos para la LinkedIn Search People API
- Incluya siempre un valor de consulta keywords significativo; una URL válida sin él crea una fila de nombre vacía cuyo comportamiento en el proveedor no es confiable.
- Recuerde que Mary Jane Smith se asigna a first_name Mary y last_name Jane Smith, y no se trata como una expresión general de palabras clave.
- No suponga que se respetan los filtros de ubicación, empresa, escuela, sector o conexiones de la URL; el adaptador actual los descarta.
- Use la URL del perfil público junto con varios atributos que lo corroboren antes de identificar a una persona.
- Deduplique los candidatos repetidos por la URL estable del perfil cuando varias búsquedas enviadas se superpongan.
- No hay un límite de resultados controlado por quien llama, así que diseñe los flujos de facturación y de revisión en torno a los resultados realmente almacenados.
APIs relacionadas
Además de la LinkedIn Search People 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 Profile Posts API — Descubre publicaciones públicas asociadas a URLs de perfiles de LinkedIn, con contexto del autor, contenido multimedia, hashtags, marcas de tiempo e interacción visible.
- LinkedIn Search Posts API — Descubre publicaciones públicas de LinkedIn indexadas por Google a partir de una palabra clave y una cadena de fecha opcional, y devuelve contenido normalizado, autores, contenido multimedia, etiquetas, marcas de tiempo e interacción visible.