LinkedIn Profiles
Un profilo LinkedIn pubblico presenta l’identità di una persona, il ruolo attuale, la località, il percorso lavorativo, la formazione, le competenze e le dimensioni del pubblico visibile. Questi dettagli supportano l’arricchimento dei contatti, la ricerca sui percorsi di carriera, le verifiche di identità e il confronto dei cambiamenti dei profili pubblici nel tempo.
Funzionalità della LinkedIn Profiles API
- Input con URL del profilo pubblicoElabora uno o più URL LinkedIn /in/{slug} senza mescolare pagine aziendali, post o offerte di lavoro.
- Contesto professionale attualeRestituisce in un unico record normalizzato nome pubblico, testo di presentazione, avatar, località, posizione e azienda attuale.
- Storico professionale strutturatoMantiene esperienze, formazione e competenze come sezioni separate, pronte per filtri, indicizzazione e arricchimento dei record.
- Metriche visibili del pubblicoRestituisce il numero di follower e di collegamenti, quando disponibile, come metriche separate accanto ai campi del profilo professionale.
Parametri della LinkedIn Profiles API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di profili LinkedIn pubblici. Ogni URL deve usare il percorso /in/{slug} su linkedin.com o su un sottodominio di LinkedIn. |
Come usare la LinkedIn Profiles API
Parti dai link ai profili che già conosci, lascia concludere l’attività sul profilo e poi leggi i record professionali pagina per pagina.
- Tieni solo i link pubblici di LinkedIn il cui percorso corrisponde a /in/{slug}.
- Invia quei link in urls a /v1/linkedin/profiles e conserva il task_id.
- Controlla /v1/tasks/{task_id} finché l’elaborazione del profilo arriva a succeeded o failed.
- Dopo il successo leggi data.results.items e segui next_cursor ogni volta che has_more è 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 trueCasi d’uso della LinkedIn Profiles API
- Arricchimento di contatti e candidati: Aggiungi ruolo attuale, azienda, località, esperienze, formazione e competenze ai record collegati a URL di profili già noti.
- Ricerca sui percorsi di carriera: Usa le sezioni strutturate di esperienze e formazione per analizzare l’evoluzione dei ruoli e il background professionale.
- Monitoraggio dei profili pubblici: Confronta le istantanee salvate dei profili per individuare cambiamenti di posizione, azienda attuale, competenze o numero visibile del pubblico.
Consigli degli esperti per la LinkedIn Profiles API
- Normalizza e deduplica gli URL /in/ prima dell’invio, così forme alternative dello stesso URL non creano record di profilo ripetuti.
- Usa l’id restituito come chiave del profilo quando è disponibile, con url come alternativa per i record senza identificatore.
- Considera esperienze, formazione, competenze e numero del pubblico come facoltativi, perché un profilo pubblico può ometterne qualsiasi parte.
- Conserva collected_at con ogni istantanea salvata quando confronti nel tempo i cambiamenti di ruolo o di pubblico.
API correlate
Oltre alla LinkedIn Profiles API, usa queste API quando ti serve un altro tipo di dati pubblici di LinkedIn.
- LinkedIn Companies API — Normalizza descrizioni pubbliche delle aziende, siti web, logo, conteggi visibili di pubblico e dipendenti, settori, sedi e specializzazioni.
- LinkedIn Posts API — Raccoglie testo dei post pubblici, autori, engagement visibile, media, data di pubblicazione, tipo e hashtag dagli URL supportati.
- LinkedIn Jobs API — Normalizza titoli delle offerte pubbliche, aziende, descrizioni, sedi, qualifiche, dettagli del contratto, link per candidarsi e campi sulla retribuzione, se disponibili.
- LinkedIn Company Jobs API — Individua le offerte di lavoro pubbliche dagli URL /jobs/ di LinkedIn preparati, con campi normalizzati di ruolo, azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e tempistiche.
- LinkedIn Company Posts API — Individua i post pubblici dagli URL delle pagine aziendali di LinkedIn con testo, contesto dell’autore, media, hashtag, date ed engagement visibile.
- LinkedIn Profile Posts API — Individua i post pubblici associati agli URL dei profili LinkedIn, con contesto dell’autore, media, hashtag, date ed engagement visibile.