API LinkedIn Profilo della persona

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
100%
Tempo medio nelle ultime 24 ore
13.96 s
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Buono

Ultime 24 ore

Ultimi 30 giorni

Cerca un membro di LinkedIn per username o link al profilo. Ottieni headline, sezione Informazioni, azienda attuale, esperienza, formazione e numero di follower e collegamenti. L'email può essere vuota e non implica il consenso a essere contattati. La chiamata non invia mai richieste di collegamento né messaggi.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su linkedin e action impostato su person_profile. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

LinkedIn Person profile legge il profilo pubblico di un membro a partire dal suo username o dal link del profilo e restituisce nome visualizzato, headline, sezione Informazioni, località, azienda attuale, numero di follower e di collegamenti, stato di verifica e stato Premium, avatar e indirizzi email quando sono pubblici. I recruiter la usano per verificare il percorso di un candidato, e i team commerciali per arricchire un lead con il ruolo e l'azienda attuali della persona prima di contattarla.

headline e about sono scritti dal membro, quindi considerali un'autodescrizione e non fatti verificati. email viene restituito solo quando è pubblico o autorizzato, quindi aspettati null nella maggior parte dei casi; emails elenca tutti gli indirizzi trovati, e email è il primo di questi. display_name può differire da username, e avatar_url può essere un URL con dimensioni specifiche e soggetto a scadenza, quindi scarica l'immagine se ti serve conservarla.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint LinkedIn Profilo della persona di EveryInfra (linkedin/person_profile).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su linkedin e action su person_profile, e inserisci i parametri in params.
- Parametri obbligatori:
  - username: Specifica l'handle dal percorso /in/ di un profilo LinkedIn o l'URL completo di un profilo personale per person_profile, oppure il percorso di un account per followers.
- Parametri facoltativi:
  - location: Specifica la località dei profili delle persone in profile_search o delle offerte di lavoro in jobs.
  - locations: Accetta un array di località come alias di compatibilità. Preferisci location: non è garantito che questo array si comporti allo stesso modo e non serve a eseguire ricerche in blocco su più paesi.
  - name: Fornisce un identificatore di compatibilità che contiene gli identificatori dell'azienda in company_profile o funge da termine di ricerca della persona in alcune ricerche person_profile.
- Restituisce un oggetto. Campi principali: username, display_name, headline, about (Testo esteso della sezione Informazioni…), location, current_company, current_company_url (URL della pagina LinkedIn dell'azienda…), current_company_logo_url (URL del logo dell'azienda attuale), member_urn, current_company_id, follower_count, connection_count (Numero di collegamenti (person_profile,…); 38 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Esempio di corpo della richiesta:
{
  "platform": "linkedin",
  "action": "person_profile",
  "params": {
    "username": "williamhgates"
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìlinkedinIdentificativo della piattaforma, valore fisso.
actionbodystringSìperson_profileIdentificativo della funzionalità, valore fisso.
usernamebody.paramsstringSì-Specifica l'handle dal percorso /in/ di un profilo LinkedIn o l'URL completo di un profilo personale per person_profile, oppure il percorso di un account per followers. Nell'azione followers restituisce il numero totale di follower, non l'elenco dei follower.
locationbody.paramsstringNo-Specifica la località dei profili delle persone in profile_search o delle offerte di lavoro in jobs. Se keyword nell'azione jobs è già un URL di ricerca completo, prevalgono i criteri contenuti nell'URL e location viene ignorato.
locationsbody.paramsarrayNo-Accetta un array di località come alias di compatibilità. Preferisci location: non è garantito che questo array si comporti allo stesso modo e non serve a eseguire ricerche in blocco su più paesi.
namebody.paramsstringNo-Fornisce un identificatore di compatibilità che contiene gli identificatori dell'azienda in company_profile o funge da termine di ricerca della persona in alcune ricerche person_profile. Non può sostituire i parametri obbligatori company o username e non garantisce corrispondenze esatte con i nomi visualizzati.

Esempi di codice

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "person_profile",
  "params": {
    "username": "williamhgates"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Acquisita il September 26, 2026 at 08:56 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti). id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "linkedin",  "action": "person_profile",  "results": {    "username": "williamhgates",    "display_name": "•••",    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",    "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",    "location": "Seattle, Washington, United States",    "current_company": "Gates Foundation",    "follower_count": 40680117,    "connection_count": 8,    "email": "•••",    "is_verified": true,    "is_premium": true,    "avatar_url": "https://media.licdn.com/•••",    "url": "https://linkedin.com/in/williamhgates",    "platform": "linkedin"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
usernameUsername (@handle).
display_nameNome visualizzato; può essere diverso da username.
headlineMantiene il significato attribuito dalla piattaforma
aboutTesto esteso della sezione Informazioni del profilo (person_profile, profile_search).
locationDescrizione della località passata così com'è; il formato varia in base alla piattaforma.
current_companyMantiene il significato attribuito dalla piattaforma
current_company_urlURL della pagina LinkedIn dell'azienda attuale.
current_company_logo_urlURL del logo dell'azienda attuale.
member_urnMantiene il significato attribuito dalla piattaforma
current_company_idMantiene il significato attribuito dalla piattaforma
follower_countFollower. null significa non reso noto, non 0.
connection_countNumero di collegamenti (person_profile, profile_search).
emailIndirizzo email. In person_profile e profile_search è un indirizzo di lavoro dedotto da informazioni pubbliche e poi convalidato; in employees è presente solo quando la fonte lo fornisce. Può essere vuoto e non implica che la persona abbia acconsentito a ricevere comunicazioni di marketing.
is_verifiedIndica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
is_premiumMantiene il significato attribuito dalla piattaforma
is_top_voiceIndica se il profilo ha il badge LinkedIn Top Voice.
is_creatorIndica se il profilo usa la modalità creator.
is_influencerMantiene il significato attribuito dalla piattaforma
open_to_workMantiene il significato attribuito dalla piattaforma
top_skillsTag delle competenze mostrati in cima al profilo.
top_education_schoolIstituto in evidenza in cima al profilo.
creator_hashtagsHashtag scelti dal creator per la modalità creator.
creator_websiteLink esterno scelto dal creator per la modalità creator.
primary_localeLocale principale dell'account (ad es. en-US).
account_created_atData e ora di creazione dell'account; null quando la fonte non le fornisce.
avatar_urlLink all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
background_picture_urlURL dell'immagine di sfondo (banner) del profilo.
urlLink al record sulla piattaforma.
experienceElenco delle esperienze lavorative (person_profile, profile_search): ogni voce riporta qualifica, azienda, URL della pagina aziendale, intervallo di date e testo della durata, oltre a location, description, employment_type e skills quando la fonte li fornisce.
educationElenco dei percorsi di studio (person_profile, profile_search): ogni voce riporta istituto, URL della pagina dell'istituto, intervallo di date e testo della durata.
featuredElenco della sezione In primo piano del profilo: ogni voce riporta tipo, titolo, descrizione, link e immagine; i post riportano anche like_count e comment_count.
first_nameNome (person_profile).
last_nameCognome (person_profile).
countryPaese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato.
cityNome della città nella lingua della piattaforma, non normalizzato.
country_codeMantiene il significato attribuito dalla piattaforma
is_memorializedIndica se l'account è commemorativo (la persona è deceduta).
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
emailsIndirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati.

FAQ

#

Dove trovo lo username?

#

Apri il profilo LinkedIn della persona: lo username è la parte dopo /in/ nell'indirizzo, ad esempio williamhgates in linkedin.com/in/williamhgates. In alternativa puoi passare il link completo del profilo. Un nome visualizzato non identifica un membro, e name è solo un indizio per la ricerca che potrebbe corrispondere a un'altra persona.

Posso cercare qualcuno senza conoscerne lo username?

#

Non con questa funzionalità, che richiede username o un link del profilo. LinkedIn Profile search trova persone in base alla qualifica attuale, facoltativamente in una determinata località, e restituisce i link dei loro profili; passa qui il link della corrispondenza giusta. Non è una ricerca esatta per nome o email.

location, locations e name filtrano il profilo?

#

No. Sono indizi facoltativi che possono aiutare a individuare il profilo, ma non restringono mai la ricerca né sostituiscono username. Una volta identificato il profilo, non hanno più alcun ruolo, quindi non affidarti a questi campi per confermare di avere la persona giusta; confronta invece headline e current_company.

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

#

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

  • Documentazione ufficiale di LinkedIn: differenze tra profilo completo e versione pubblica esterna ↗

    Le versioni pubbliche non mostrano i dati completi del profilo; per vedere un profilo completo può essere necessario accedere, e le sezioni mostrate restano soggette alle impostazioni dell'utente. Di conseguenza, `person_profile` non può essere presentato come un modo per ottenere il profilo completo di chiunque, e la documentazione ufficiale sulla visibilità non costituisce un'autorizzazione alla raccolta dei dati.

    Verificato il 2026-09-04

  • «User Agreement» di LinkedIn: i profili pubblici restano soggetti alle condizioni d'uso ↗

    Le informazioni del profilo e della rete restano soggette allo «User Agreement», alle restrizioni di accesso e ai requisiti sulla privacy. Le descrizioni di parametri e campi su questo sito non costituiscono prova di autorizzazione da parte della piattaforma né di autorizzazione a contattare le persone interessate.

    Verificato il 2026-09-04

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy