API LinkedIn Profilo della persona
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
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
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | linkedin | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | person_profile | Identificativo della funzionalità, valore fisso. |
username | body.params | string | Sì | - | 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. |
location | body.params | string | No | - | 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. |
locations | body.params | array | No | - | 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 | body.params | string | No | - | 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
#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
#{ "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.
| Campo | Significato |
|---|---|
username | Username (@handle). |
display_name | Nome visualizzato; può essere diverso da username. |
headline | Mantiene il significato attribuito dalla piattaforma |
about | Testo esteso della sezione Informazioni del profilo (person_profile, profile_search). |
location | Descrizione della località passata così com'è; il formato varia in base alla piattaforma. |
current_company | Mantiene il significato attribuito dalla piattaforma |
current_company_url | URL della pagina LinkedIn dell'azienda attuale. |
current_company_logo_url | URL del logo dell'azienda attuale. |
member_urn | Mantiene il significato attribuito dalla piattaforma |
current_company_id | Mantiene il significato attribuito dalla piattaforma |
follower_count | Follower. null significa non reso noto, non 0. |
connection_count | Numero di collegamenti (person_profile, profile_search). |
email | Indirizzo 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_verified | Indica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo. |
is_premium | Mantiene il significato attribuito dalla piattaforma |
is_top_voice | Indica se il profilo ha il badge LinkedIn Top Voice. |
is_creator | Indica se il profilo usa la modalità creator. |
is_influencer | Mantiene il significato attribuito dalla piattaforma |
open_to_work | Mantiene il significato attribuito dalla piattaforma |
top_skills | Tag delle competenze mostrati in cima al profilo. |
top_education_school | Istituto in evidenza in cima al profilo. |
creator_hashtags | Hashtag scelti dal creator per la modalità creator. |
creator_website | Link esterno scelto dal creator per la modalità creator. |
primary_locale | Locale principale dell'account (ad es. en-US). |
account_created_at | Data e ora di creazione dell'account; null quando la fonte non le fornisce. |
avatar_url | Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere. |
background_picture_url | URL dell'immagine di sfondo (banner) del profilo. |
url | Link al record sulla piattaforma. |
experience | Elenco 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. |
education | Elenco dei percorsi di studio (person_profile, profile_search): ogni voce riporta istituto, URL della pagina dell'istituto, intervallo di date e testo della durata. |
featured | Elenco 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_name | Nome (person_profile). |
last_name | Cognome (person_profile). |
country | Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato. |
city | Nome della città nella lingua della piattaforma, non normalizzato. |
country_code | Mantiene il significato attribuito dalla piattaforma |
is_memorialized | Indica se l'account è commemorativo (la persona è deceduta). |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
emails | Indirizzi 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.
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