LinkedIn API8 min read

Cos'è l'API LinkedIn? Guida completa su come funziona nel 2026

K
Kavya M
GTM Engineer

LinkedIn è molto più di un sito di networking professionale: è una potente piattaforma aziendale usata da oltre 1 miliardo di persone in tutto il mondo. Scopri tutto sull'API LinkedIn nel 2026, come funziona, come accedervi legalmente e come piattaforme come OutX.ai rendono più facile il prospecting LinkedIn.

Cos'è l'API LinkedIn?

L'API LinkedIn (Application Programming Interface) è un insieme di strumenti e servizi forniti da LinkedIn che consente agli sviluppatori e alle aziende autorizzate di accedere ai dati LinkedIn in modo sicuro e strutturato.

Invece di copiare i dati manualmente, l'API consente di accedere a:

  • Dettagli del profilo pubblico
  • Titoli di lavoro ed esperienze
  • Informazioni aziendali
  • Post degli utenti
  • Connessioni
  • Titoli e sommari del profilo

Questa API è utile per le aziende che vogliono integrare le funzionalità di LinkedIn nelle proprie piattaforme, ad esempio strumenti di social selling, software di marketing o sistemi HR.

Tuttavia, LinkedIn limita l'accesso a questi dati. Devi essere un LinkedIn Partner ufficiale per usare la maggior parte delle funzionalità nell'API LinkedIn.

Come diventare un LinkedIn Partner

Per usare completamente l'API di LinkedIn, devi unirti a uno dei loro programmi partner. Questi programmi sono progettati per le aziende che rientrano in una di queste categorie:

  • Talent Solutions (HR tech e strumenti di reclutamento)
  • Marketing Solutions (piattaforme di marketing e analytics)
  • Integrazioni Sales Navigator (strumenti che supportano il prospecting vendite)
  • Integrazioni LinkedIn Learning (piattaforme educative)

Per fare richiesta:

  1. Vai al LinkedIn Developer Portal.
  2. Scegli il programma partner appropriato.
  3. Invia una richiesta spiegando come prevedi di usare l'API.

Una volta accettato, puoi accedere ai prodotti API avanzati di LinkedIn come:

  • Profile API
  • Connections API
  • Posts API (sostituisce le legacy UGC e Share API)
  • Organization API
  • Community Management API
  • Compliance API

Questi strumenti sono potenti, ma sono disponibili solo per i partner approvati. Da notare che LinkedIn ora richiede che tutte le richieste Marketing API includano un header Linkedin-Version nel formato YYYYMM (es. 202602), e le versioni sono supportate per un minimo di un anno.

Quanto costa l'API LinkedIn?

LinkedIn offre vari piani tariffari per la sua API a seconda di quanti dati vuoi accedere:

PianoCosto mensileLimite accesso profili
BasicGratuitoFino a 3 profili
Standard$59/meseFino a 500 profili
Premium$499/meseFino a 10.000 profili

Scegli un piano in base a quanti profili o aziende devi analizzare ogni mese. Per casi d'uso piccoli, il piano Basic potrebbe essere sufficiente. Per il prospecting o il reclutamento su larga scala, Premium offre più flessibilità.

Come funziona l'API LinkedIn?

L'API LinkedIn funziona tramite richieste autorizzate effettuate dalla tua applicazione. Ecco una panoramica di come opera:

1. Prodotti per gli sviluppatori

LinkedIn fornisce diversi tipi di API per casi d'uso specifici:

  • Consumer: accesso con LinkedIn, condivisione dei contenuti
  • Marketing: performance degli annunci, coinvolgimento del pubblico
  • Sales: migliorare le funzionalità di Sales Navigator
  • Talent: reclutare i migliori talenti usando gli insight del profilo
  • Learning: integrare contenuti educativi
  • Plugin: aggiungere pulsanti LinkedIn ai siti web
  • Regulatory: garantire che l'accesso ai dati sia conforme alle leggi

Ogni categoria viene fornita con il proprio insieme di autorizzazioni e limiti.

2. Autorizzazione: OAuth 2.0

LinkedIn usa OAuth 2.0 per garantire che tutto l'utilizzo dell'API sia sicuro e basato su permessi. Ci sono due tipi principali di flussi di autorizzazione:

  • OAuth a 3 gambe (Autorizzazione membro): richiede a un utente di dare il permesso alla tua app di accedere ai suoi dati. LinkedIn ora usa OpenID Connect per l'accesso dei membri.
  • OAuth a 2 gambe (Autorizzazione applicazione): usato per accedere a dati non specifici dell'utente, come analytics o statistiche della pagina aziendale.

Importante (aggiornamento 2026): LinkedIn ha deprecato gli scope classici r_liteprofile e r_emailaddress. Tutte le nuove app devono usare invece gli scope OpenID Connect:

  • openid - Richiesto per l'autenticazione OpenID Connect
  • profile - Informazioni di base del profilo (sostituisce r_liteprofile)
  • email - Indirizzo email (sostituisce r_emailaddress)
  • w_member_social - Capacità di condividere post
  • r_organization_social - Leggere i contenuti aziendali

Le informazioni del profilo per i membri autenticati vengono ora recuperate tramite l'endpoint /v2/userinfo piuttosto che gli endpoint legacy del profilo.

3. Versioning dell'API (novità del 2025-2026)

LinkedIn ora pubblica nuove versioni dell'API Marketing mensilmente usando il formato YYYYMM. Ogni versione è supportata per almeno un anno. Per usare l'API, includi l'header della versione in ogni richiesta:

Linkedin-Version: 202602

Deprecazioni chiave da tenere a mente:

  • Le API Marketing non versionate legacy (percorso base https://api.linkedin.com/v2/) sono state completamente dismesse
  • Le API Legacy Lead Sync (/adForms, /adFormResponses, /leadNotificationUrls) sono state dismesse il 31 luglio 2025
  • L'UGC Post API è ora legacy: usa invece la Posts API
  • Il parametro isDsc nella Posts API è deprecato; i post organici e sponsorizzati vengono restituiti insieme per default

4. Limiti di velocità dell'API

LinkedIn impone limiti giornalieri sul numero di chiamate API che un'app può effettuare. Se superi questo limite, LinkedIn restituirà un errore 429, che indica "Too Many Requests."

Per evitarlo:

  • Tieni traccia dell'utilizzo dell'API
  • Ottimizza le richieste di dati
  • Usa il batching quando possibile

5. Protezione dei dati ed etica

LinkedIn è rigido sulla privacy dei dati. La tua app deve:

  • Usare HTTPS per tutte le trasmissioni di dati
  • Evitare di fare spam agli utenti
  • Non memorizzare mai i dati sensibili in posizioni non protette
  • Seguire le linee guida GDPR e CCPA

Questo è particolarmente importante per gli strumenti che gestiscono grandi volumi di dati degli utenti.

Come configurare l'API LinkedIn (passo dopo passo)

Se sei uno sviluppatore o parte di un'azienda che desidera configurare l'API LinkedIn, segui questi passaggi:

Passo 1: crea un'app

  • Vai al LinkedIn Developer Portal
  • Clicca su Crea app e compila il nome dell'azienda, il logo, il sito web e l'email aziendale.

Passo 2: verifica la tua azienda

  • Aggiungi la pagina LinkedIn dell'azienda all'app
  • Invia il link di verifica all'admin della pagina
  • Una volta verificato, riceverai una chiave API e le credenziali del client

Passo 3: configura OAuth 2.0 con OpenID Connect

  • Registra l'URI di reindirizzamento della tua app
  • Scegli il prodotto giusto (es. Community Management API, Advertising API)
  • Per l'accesso dei membri, usa OpenID Connect con gli scope openid, profile e email
  • Abilita le autorizzazioni richieste in base ai dati a cui devi accedere
  • Includi l'header Linkedin-Version (es. 202602) in tutte le richieste Marketing API

Passo 4: usa l'API in modo sicuro

  • Archivia la chiave API e i segreti del client in un vault sicuro
  • Monitora l'utilizzo dei token e aggiorna i token scaduti
  • Non esporre mai i segreti nel codice front-end

Segui la guida rapida dell'API OutX per effettuare la prima chiamata API in pochi minuti.

Come analizzare un token

LinkedIn offre uno strumento di introspezione dei token che aiuta a verificare se il tuo token OAuth è attivo.

Per testare un token:

curl --location --request POST 'https://www.linkedin.com/oauth/v2/introspectToken' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=<Client ID>' \
--data-urlencode 'client_secret=<Client Secret>' \
--data-urlencode 'token=<Il tuo token>'

Riceverai dettagli come:

  • Se il token è attivo
  • Tempo di scadenza
  • Autorizzazioni concesse
  • Tipo di autorizzazione (2L, 3L, o Enterprise)

Questo aiuta a garantire che l'integrazione funzioni correttamente e in modo sicuro.

Cosa c'è di nuovo nell'API LinkedIn (2025-2026)

LinkedIn continua a far evolvere la sua piattaforma API. Ecco gli aggiornamenti più importanti per il 2025-2026:

  • Community Management API: questa API ora gestisce la creazione di contenuti inclusi post di testo, immagini, video (con miniature e sottotitoli), post carosello, sondaggi e commenti/reazioni per conto di organizzazioni e brand.
  • Endpoint Video Analytics: i partner della Community Management API possono recuperare le metriche VIDEO_PLAY, VIDEO_WATCH_TIME e VIDEO_VIEWER per i post video dei membri tramite il nuovo endpoint GET /memberCreatorVideoAnalytics (a partire dalla versione 202506).
  • Miglioramenti all'Analytics degli annunci: a partire dalla versione 202601, l'endpoint /adAnalytics include le metriche EventWatchTime e VideoWatchTime per misurare le visualizzazioni degli eventi, il tempo di visione e il costo per visualizzazione dell'evento.
  • Preferenze di fiducia dell'account pubblicitario: a partire dalla versione 202509, il nuovo endpoint /adAccountTrustPreferences consente di creare e gestire le restrizioni degli editori di annunci a livello di account.
  • Catalogo degli endpoint del prodotto API: LinkedIn ha introdotto un nuovo catalogo sul Developer Portal che fornisce una visione olistica di quali endpoint e autorizzazioni la tua applicazione può accedere.
  • Versioning mensile: LinkedIn ora pubblica nuove versioni dell'API mensilmente e supporta ogni versione per almeno un anno, rendendo più facile pianificare le migrazioni.

Lo scraping di LinkedIn è legale?

LinkedIn vieta esplicitamente il scraping dei suoi dati usando bot o script automatizzati. Il scraping viola i loro Termini di servizio e può risultare in ban o azioni legali.

Invece, LinkedIn incoraggia l'uso della sua API ufficiale, che è regolamentata, autorizzata e conforme alle leggi globali sulla protezione dei dati.

Se non sei un LinkedIn Partner o non hai accesso all'API, usare strumenti di terze parti comporta dei rischi.

Alternative all'API LinkedIn

Ottenere l'accesso all'API LinkedIn non è sempre facile. Richiede competenza tecnica, tempo e approvazioni. Ecco perché molte aziende si rivolgono a strumenti di scraping LinkedIn come:

  • Evaboot: scrapa i dati da LinkedIn Sales Navigator
  • PhantomBuster: automatizza le attività LinkedIn
  • TexAu: automatizza l'outreach LinkedIn

Sebbene questi strumenti siano utili, vengono con limitazioni e potenziali rischi legali.

Vedi la documentazione dell'API OutX LinkedIn per un riferimento API completo con esempi di codice.

Come aiuta OutX.ai

OutX.ai è una potente piattaforma che semplifica il prospecting LinkedIn senza richiedere agli utenti di gestire configurazioni API complesse o regole di scraping.

Abbiamo progettato OutX.ai per aiutarti a:

  • Trovare lead verificati rapidamente e facilmente
  • Arricchire i dati di contatto usando fonti affidabili
  • Automatizzare il prospecting su tutti i canali
  • Restare conforme ai termini di LinkedIn e alle normative sui dati

Invece di trascorrere ore a costruire un'integrazione LinkedIn, puoi usare OutX.ai per generare liste di lead pronte per l'outreach e ottenere risultati reali.

Che tu sia nelle vendite, nel marketing o nel reclutamento, OutX.ai ti dà il vantaggio senza il mal di testa tecnico.

Conclusione

L'API LinkedIn è uno strumento potente ma strettamente controllato che può aiutarti a costruire prodotti più intelligenti, gestire campagne migliori e migliorare l'outreach. Ma l'accesso all'API è limitato, richiede approvazione e viene fornito con rigide regole di conformità.

Per le aziende che hanno bisogno di velocità, flessibilità e facilità d'uso, OutX.ai offre un percorso migliore. Puoi arricchire i dati, connetterti con i lead e ottimizzare l'outreach, tutto senza dover toccare l'API LinkedIn tu stesso.

Se sei curioso di modi più intelligenti per sfruttare i dati LinkedIn per la crescita, prova OutX.ai oggi.

Vuoi aiuto con il prospecting LinkedIn? Contatta il nostro team e ti mostreremo come OutX.ai può funzionare per te.