API LinkedIn Ricerca profili

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Cerca profili di membri LinkedIn per ruolo attuale in keyword e una località facoltativa, con headline, azienda e ruolo attuali e, dove visibile, esperienza lavorativa. Non cerca persone per nome esatto o email, e una corrispondenza non conferma identità, esperienza o disponibilità lavorativa.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su linkedin e action impostato su profile_search. 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.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint LinkedIn Ricerca profili di EveryInfra (linkedin/profile_search).

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 profile_search, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Specifica la stringa di ricerca: una parola chiave per la ricerca dei post in search, la qualifica attuale in profile_search, oppure un termine di ricerca o l'URL completo di un'offerta di lavoro in jobs.
- 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.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 10)
- Restituisce un elenco di record. Campi principali di ogni record: id, username, name, url, headline, location, current_company, current_title, avatar_url, is_premium, is_open_profile, email (Indirizzo email); 22 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Esempio di corpo della richiesta:
{
  "platform": "linkedin",
  "action": "profile_search",
  "params": {
    "keyword": "software engineer"
  }
}
- 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ìprofile_searchIdentificativo della funzionalità, valore fisso.
keywordbody.paramsstringSì-Specifica la stringa di ricerca: una parola chiave per la ricerca dei post in search, la qualifica attuale in profile_search, oppure un termine di ricerca o l'URL completo di un'offerta di lavoro in jobs. La ricerca di persone con questo parametro non trova corrispondenze esatte per nome o email.
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.
limitbody.paramsinteger (1–100)No10Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito.

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": "profile_search",
  "params": {
    "keyword": "software engineer"
  }
}'

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); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "linkedin",  "action": "profile_search",  "results": [    {      "id": "•••",      "username": "•••",      "name": "•••",      "url": "https://linkedin.com/•••",      "headline": "•••",      "location": "•••",      "avatar_url": "https://media.licdn.com/•••",      "is_premium": false,      "is_open_profile": false,      "platform": "linkedin"    },    {      "id": "•••",      "username": "•••",      "name": "•••",      "url": "https://linkedin.com/•••",      "headline": "•••",      "location": "•••",      "avatar_url": "https://media.licdn.com/•••",      "is_premium": false,      "is_open_profile": false,      "platform": "linkedin"    }  ],  "count": 10,  "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
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
usernameUsername (@handle).
nameNome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
urlLink al record sulla piattaforma.
headlineMantiene il significato attribuito dalla piattaforma
locationDescrizione della località passata così com'è; il formato varia in base alla piattaforma.
current_companyMantiene il significato attribuito dalla piattaforma
current_titleMantiene il significato attribuito dalla piattaforma
avatar_urlLink all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
is_premiumMantiene il significato attribuito dalla piattaforma
is_open_profileMantiene il significato attribuito dalla piattaforma
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.
aboutTesto esteso della sezione Informazioni del profilo (person_profile, profile_search).
follower_countFollower. null significa non reso noto, non 0.
connection_countNumero di collegamenti (person_profile, profile_search).
is_verifiedIndica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
is_creatorIndica se il profilo usa la modalità creator.
is_influencerMantiene il significato attribuito dalla piattaforma
is_top_voiceIndica se il profilo ha il badge LinkedIn Top Voice.
current_company_urlURL della pagina LinkedIn dell'azienda attuale.
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.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

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: i profili pubblici possono includere solo alcune sezioni ↗

    La documentazione ufficiale precisa che i profili pubblici sono versioni semplificate in cui gli utenti scelgono quali sezioni restano visibili, e che a volte ne risultano anteprime ridotte. I profili restituiti come possibili risultati della ricerca non equivalgono a cronologie lavorative complete, dati di contatto o identità verificate.

    Verificato il 2026-09-04

  • «User Agreement» di LinkedIn: limiti allo scraping, alla copia e al riutilizzo ↗

    La sezione 8.2 dello «User Agreement» limita lo scraping automatizzato, l'elusione dei controlli di accesso e la copia, l'uso, la visualizzazione o la distribuzione di contenuti senza il consenso dei titolari dei diritti, inclusi i contenuti ottenuti tramite terze parti. Un'eventuale autorizzazione scritta separata va confermata in modo indipendente, e la disponibilità pubblica non costituisce un'esenzione.

    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