linkedin/
profiles

Recupera i profili LinkedIn pubblici da URL /in/{slug}, con identità normalizzata e ruolo attuale, storico professionale, competenze, località e numero visibile di follower e collegamenti.

LinkedIn Profiles API

Input con URL del profilo
Contesto professionale
Istantanea pubblica
2,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Tieni solo i link pubblici di LinkedIn il cui percorso corrisponde a /in/{slug}.
  2. Invia quei link in urls a /v1/linkedin/profiles e conserva il task_id.
  3. Controlla /v1/tasks/{task_id} finché l’elaborazione del profilo arriva a succeeded o failed.
  4. 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 true

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

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.

Esplora altre piattaforme

Combina i dati di LinkedIn con i dati pubblici delle altre piattaforme social supportate.

LinkedIn Profiles API — FAQ

LinkedIn Profiles API recupera dati professionali pubblici da uno o più URL /in/{slug} accettati. Restituisce identità normalizzata, ruolo attuale, località, esperienze, formazione, competenze e il numero disponibile di follower e collegamenti.

Invia URL LinkedIn completi, http o https, il cui percorso corrisponde a /in/{slug}. Pagine aziendali, post, feed e link a offerte di lavoro non sono input validi per i profili.

No. I risultati si limitano ai campi visibili sul profilo pubblico al momento dell’elaborazione, e la risposta non aggiunge dati privati dei membri.

Esperienze, formazione, competenze, numero del pubblico e altri campi facoltativi possono essere null o vuoti quando il profilo pubblico non li espone.

La fatturazione si basa sui profili restituiti, a 2,5 crediti SocQ per risultato. Se un’attività completata non restituisce alcun profilo, non viene addebitato nulla.