LinkedIn Profiles
Un perfil público de LinkedIn presenta la identidad de una persona profesional, su puesto actual, ubicación, historial laboral, formación, habilidades y el tamaño visible de su audiencia. Estos detalles sirven para enriquecer contactos, investigar trayectorias profesionales, verificar identidades y comparar los cambios en los perfiles públicos a lo largo del tiempo.
Funcionalidades de la LinkedIn Profiles API
- Entrada por URL de perfil públicoProcesa una o más URL /in/{slug} de LinkedIn sin mezclar páginas de empresa, publicaciones ni ofertas de empleo.
- Contexto profesional actualDevuelve en un solo registro normalizado el nombre público, el texto de presentación, el avatar, la ubicación, el puesto y la empresa actual.
- Trayectoria profesional estructuradaConserva la experiencia, la formación y las habilidades como secciones separadas para filtrar, indexar y enriquecer registros.
- Métricas de audiencia visiblesDevuelve los números de seguidores y de conexiones disponibles como métricas separadas junto con los campos del perfil profesional.
Parámetros de la LinkedIn Profiles API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de perfiles de LinkedIn. Cada URL debe usar la ruta /in/{slug} en linkedin.com o en un subdominio de LinkedIn. |
Cómo usar la LinkedIn Profiles API
Parta de enlaces de perfiles conocidos, deje que termine la tarea de perfiles y consuma los registros de trayectoria página por página.
- Conserve solo los enlaces públicos de LinkedIn cuya ruta coincida con /in/{slug}.
- Envíe esos enlaces en urls a /v1/linkedin/profiles y conserve el task_id.
- Revise /v1/tasks/{task_id} hasta que el procesamiento de los perfiles llegue a succeeded o failed.
- Tras el éxito, lea data.results.items y siga next_cursor siempre que has_more sea true.
curl -X POST "https://api.socq.ai/v1/linkedin/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la LinkedIn Profiles API
- Enriquecimiento de contactos y candidatos: Agregue el puesto actual, la empresa, la ubicación, la experiencia, la formación y las habilidades a los registros vinculados con URL de perfiles conocidas.
- Investigación de trayectorias profesionales: Use las secciones estructuradas de experiencia y formación para examinar la progresión de puestos y la trayectoria profesional.
- Monitoreo de perfiles públicos: Compare las instantáneas de perfiles guardadas para identificar cambios en el puesto, la empresa actual, las habilidades o los conteos visibles de audiencia.
Consejos de expertos para la LinkedIn Profiles API
- Normalice y deduplique las URL /in/ antes del envío para que las formas alternativas de URL no generen registros de perfil repetidos.
- Use el id devuelto como clave del perfil cuando esté disponible y url como alternativa para los registros sin identificador.
- Trate la experiencia, la formación, las habilidades y los conteos de audiencia como opcionales, porque un perfil público puede omitir cualquiera de ellos.
- Conserve collected_at con cada instantánea almacenada al comparar los cambios de puesto o de audiencia a lo largo del tiempo.
APIs relacionadas
Además de la LinkedIn Profiles API, use estas APIs cuando necesite otro tipo de datos públicos de LinkedIn.
- 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.
- 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.