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

Scopri chi lavora in un'azienda su LinkedIn. Passa il nome breve o il link /company/ in company. Ottieni nome, headline, località e link al profilo di ogni persona. Le righe sono un campione dei profili rilevati, non un elenco ufficiale, aggiornato o completo del personale.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su linkedin e action impostato su employees. 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 Employees elenca un campione pubblico delle persone che lavorano in un'azienda, a partire dal nome breve LinkedIn o dal link alla pagina /company/ indicato in company. Ogni riga contiene nome, headline, località con paese, codice paese e città, link al profilo, avatar, se la persona ha un account Premium, se è un influencer, se si è dichiarata in cerca di lavoro e i dati di contatto, quando disponibili. I team commerciali lo usano per mappare le persone di un account target, i recruiter per trovare candidati e gli analisti per vedere dove si trova il personale di un'azienda.

L'elenco è un campione, non un organico completo, quindi non usarne la lunghezza come numero di dipendenti. headline è la breve frase che ogni persona scrive su di sé. open_to_work indica le persone che hanno segnalato pubblicamente di cercare lavoro, e email viene restituita solo quando è pubblica o quando l'accesso è autorizzato; per questo è null per la maggior parte delle righe.

Prompt per l'AI

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

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 employees, e inserisci i parametri in params.
- Parametri obbligatori:
  - company: Specifica il nome breve dell'azienda su LinkedIn o l'URL del profilo /company/ per company_profile ed employees, non una ragione sociale qualsiasi.
- Parametri facoltativi:
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 200. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, name, headline, location, country, country_code, city, avatar_url, is_premium, is_influencer, open_to_work; 25 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Esempio di corpo della richiesta:
{
  "platform": "linkedin",
  "action": "employees",
  "params": {
    "company": "google"
  }
}
- 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ìemployeesIdentificativo della funzionalità, valore fisso.
companybody.paramsstringSì-Specifica il nome breve dell'azienda su LinkedIn o l'URL del profilo /company/ per company_profile ed employees, non una ragione sociale qualsiasi. L'azione employees espande i nomi brevi in URL aziendali completi per restituire un campione pubblico di dipendenti, che non garantisce l'elenco completo del personale attuale.
limitbody.paramsinteger (1–200)No20Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 200. 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": "employees",
  "params": {
    "company": "google"
  }
}'

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 October 24, 2026 at 18:28 (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": "employees",  "results": [    {      "id": "•••",      "url": "https://linkedin.com/•••",      "name": "•••",      "headline": "•••",      "location": "•••",      "country": "United States",      "country_code": "US",      "city": "Mountain View, California",      "avatar_url": "",      "is_premium": true,      "is_influencer": false,      "open_to_work": false,      "company_url": "https://www.linkedin.com/company/google",      "is_creator": false,      "is_top_voice": false,      "is_memorialized": false,      "account_created_at": "2004-04-26T01:31:42+00:00",      "primary_locale": "en_US",      "member_urn": "•••",      "first_name": "•••",      "last_name": "•••",      "company_id": "1441",      "platform": "linkedin"    },    {      "id": "•••",      "url": "https://linkedin.com/•••",      "name": "•••",      "headline": "•••",      "location": "•••",      "country": "United Kingdom",      "country_code": "GB",      "city": "London, England",      "avatar_url": "https://media.licdn.com/•••",      "is_premium": false,      "is_influencer": false,      "open_to_work": false,      "company_url": "https://www.linkedin.com/company/google",      "is_creator": true,      "is_top_voice": false,      "is_memorialized": false,      "account_created_at": "2006-02-01T02:16:53+00:00",      "primary_locale": "en_US",      "member_urn": "•••",      "first_name": "•••",      "last_name": "•••",      "company_id": "1441",      "platform": "linkedin"    }  ],  "count": 20,  "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.
urlLink al record sulla piattaforma.
nameNome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
headlineMantiene il significato attribuito dalla piattaforma
locationDescrizione della località passata così com'è; il formato varia in base alla piattaforma.
countryPaese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato.
country_codeMantiene il significato attribuito dalla piattaforma
cityNome della città nella lingua della piattaforma, non normalizzato.
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_influencerMantiene il significato attribuito dalla piattaforma
open_to_workMantiene il significato attribuito dalla piattaforma
company_urlLink alla pagina aziendale.
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.
phoneNumero di telefono di contatto, passato senza normalizzarne il formato.
is_creatorIndica se il profilo usa la modalità creator.
is_top_voiceIndica se il profilo ha il badge LinkedIn Top Voice.
is_memorializedIndica se l'account è commemorativo (la persona è deceduta).
account_created_atData e ora di creazione dell'account; null quando la fonte non le fornisce.
primary_localeLocale principale dell'account (ad es. en-US).
postal_codeCodice postale della località del profilo (employees; solo quando la fonte lo fornisce).
member_urnMantiene il significato attribuito dalla piattaforma
first_nameNome (person_profile).
last_nameCognome (person_profile).
company_idMantiene il significato attribuito dalla piattaforma
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

#

È l'elenco completo dei dipendenti di un'azienda?

#

No. Restituisce un campione pubblico dei dipendenti, non l'organico completo. Per il numero di dipendenti usa quello riportato da LinkedIn Company profile, e considera questo elenco come una panoramica di ruoli e località, non come un conteggio del personale.

Come raggruppo i dipendenti per paese o città?

#

Usa country_code anziché country, che a seconda del record può essere un nome completo o un codice ISO. city è scritto nella lingua della piattaforma e non è normalizzato, quindi uniforma i nomi delle città prima di contarli, e ripiega su location, il testo grezzo della località, quando city è vuoto.

Come leggo il profilo completo di una persona?

#

Quando url è il link al profilo /in/ della persona, passalo alla funzionalità LinkedIn Person profile, che accetta il link completo di un profilo e restituisce la sezione Informazioni, l'azienda attuale, il numero di follower e di collegamenti e altro ancora. Qui headline è solo la breve frase che la persona ha scritto su di sé.

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.

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