linkedin/
search-people

Trova profili LinkedIn pubblici candidati a partire da URL di ricerca di persone, con identità normalizzata, descrizione, immagini, località, sito web, segnali dell’account e metriche disponibili.

LinkedIn Search People API

Input con URL di ricerca
Ricerca per nome
Account canonici
1 credito per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Crea un URL di ricerca di persone su LinkedIn con un valore keywords che contiene il nome della persona.
  2. Invia con POST urls a /v1/linkedin/search-people e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di LinkedIn con i dati pubblici delle altre piattaforme social supportate.

LinkedIn Search People API — FAQ

LinkedIn Search People API è un’interfaccia programmatica per trovare profili LinkedIn pubblici candidati a partire da URL di ricerca di persone. Associa il valore keywords dell’URL a un’interrogazione del provider orientata al nome e restituisce record di account pubblici normalizzati da verificare.

Ogni valore deve essere un URL completo, http o https, su linkedin.com o su un sottodominio di LinkedIn, con un percorso che inizia con /search/results/people.

Dopo la decodifica, il valore viene diviso sugli spazi. Il primo elemento diventa first_name e tutti gli altri vengono uniti in last_name.

No. L’adattatore attuale non associa i filtri codificati per località, azienda, scuola, settore, grado di collegamento o altri filtri di ricerca.

No. Questo endpoint non espone alcun limite di risultati controllato da chi chiama e salva i record prodotti dalla fonte di ricerca per ogni URL inviato.

No. I nomi non sono univoci. Considera ogni risultato un candidato e verifica con riscontri l’URL pubblico, il nome, la descrizione, la località e gli altri attributi visibili.

Ogni risultato di profilo salvato con successo costa 1 credito SocQ, senza costo di base. Le stime di pianificazione usano 100 risultati per URL, i set di risultati vuoti non hanno costi per risultato e l’utilizzo effettivo può variare perché non è esposto alcun limite di risultati.