LinkedIn Search People
LinkedIn Search People trasforma il valore keywords di ogni URL di ricerca di persone inviato in un’interrogazione del provider orientata al nome. I risultati sono profili pubblici candidati da verificare, non la prova che un profilo appartenga alla persona cercata, e l’endpoint non riapplica i filtri per azienda, scuola, località, settore o collegamento codificati nell’URL.
Funzionalità della LinkedIn Search People API
- Input con URL di ricerca di personeInvia uno o più URL LinkedIn pubblici i cui percorsi iniziano con /search/results/people.
- Mappatura esplicita del nomeDecodifica keywords, associa a first_name il primo elemento separato da spazi e unisce gli elementi restanti in last_name.
- Ricerca di profili candidatiRicevi URL di profili pubblici e contesto sull’identità, utili per l’abbinamento manuale o per una successiva raccolta specifica del profilo.
- Record di account canoniciRestituisce campi stabili di identità, descrizione, immagine, sito web, stato dell’account, località, metriche e raccolta.
- Fedeltà alla fonte con valori nulliLascia null i campi non disponibili ed evita di dedurre dati di contatto privati, storico lavorativo, formazione, competenze o certezza dell’identità.
Parametri della LinkedIn Search People API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL LinkedIn pubblici, http o https. Ogni host deve essere linkedin.com o un sottodominio di LinkedIn, e ogni percorso deve iniziare con /search/results/people. Includi keywords per un comportamento affidabile orientato al nome. |
Come usare la LinkedIn Search People API
Prepara URL di ricerca di persone orientati al nome, invia l’attività asincrona e controlla ogni candidato restituito.
- Crea un URL di ricerca di persone su LinkedIn con un valore keywords che contiene il nome della persona.
- Invia con POST urls a /v1/linkedin/search-people e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
- Dopo il successo elabora data.results.items e segui next_cursor ogni volta che has_more è true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della LinkedIn Search People API
- Ricerca di URL di profili: Trova gli URL di profili LinkedIn pubblici candidati prima di usare un endpoint di raccolta specifico per il profilo.
- Risoluzione manuale dell’identità: Confronta nomi, descrizioni, località, immagini e URL tra i candidati, tenendo conto dell’incertezza.
- Raccolta da elenchi pubblici: Invia gli account candidati normalizzati a una coda di revisione, senza promettere arricchimento dei contatti o attributi privati.
- Ricerca sulle varianti del nome: Esegui separatamente grafie del nome scelte con cura e confronta i candidati pubblici prodotti a ogni momento di raccolta.
Consigli degli esperti per la LinkedIn Search People API
- Includi sempre un valore keywords significativo; un URL valido che ne è privo crea una riga di nome vuota, con un comportamento del provider non affidabile.
- Ricorda che Mary Jane Smith viene associato a first_name Mary e a last_name Jane Smith, e non trattato come un’espressione generica di parole chiave.
- Non dare per scontato che i filtri per località, azienda, scuola, settore o collegamento nell’URL vengano rispettati; l’adattatore attuale li scarta.
- Usa l’URL del profilo pubblico insieme a più attributi concordanti prima di identificare una persona.
- Deduplica i candidati ripetuti per URL stabile del profilo quando più ricerche inviate si sovrappongono.
- Non esiste un limite di risultati controllato da chi chiama, quindi imposta fatturazione e flussi di revisione in base ai risultati effettivamente salvati.
API correlate
Oltre alla LinkedIn Search People API, usa queste API quando ti serve un altro tipo di dati pubblici di LinkedIn.
- LinkedIn Profiles API — Normalizza identità del profilo pubblico, ruoli, località, conteggi visibili del pubblico, esperienze, formazione e competenze a partire dagli URL dei profili.
- LinkedIn Companies API — Normalizza descrizioni pubbliche delle aziende, siti web, logo, conteggi visibili di pubblico e dipendenti, settori, sedi e specializzazioni.
- LinkedIn Posts API — Raccoglie testo dei post pubblici, autori, engagement visibile, media, data di pubblicazione, tipo e hashtag dagli URL supportati.
- LinkedIn Jobs API — Normalizza titoli delle offerte pubbliche, aziende, descrizioni, sedi, qualifiche, dettagli del contratto, link per candidarsi e campi sulla retribuzione, se disponibili.
- LinkedIn Profile Posts API — Individua i post pubblici associati agli URL dei profili LinkedIn, con contesto dell’autore, media, hashtag, date ed engagement visibile.
- LinkedIn Search Posts API — Individua i post pubblici di LinkedIn indicizzati da Google per parola chiave e stringa di data facoltativa, restituendo contenuti, autori, media, tag, date ed engagement visibile in forma normalizzata.