Skip to main content
POST
POST
Esegui una ricerca asincrona per trovare un numero di telefono e il paese associato. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. La ricerca deve contenere uno dei seguenti elementi:
  • L’URL del profilo LinkedIn di una persona (ad es. https://www.linkedin.com/in/michael-scott/)
  • La combinazione di informazioni individuali: firstname + lastname + (company_name o company_domain)
L’URL LinkedIn prevarrà sempre sulle informazioni individuali se entrambi sono presenti, poiché è il modo migliore per identificare in modo univoco una singola persona ed evitare problemi legati all’omonimia.

Corpo della richiesta

Opzione 1 (Consigliata):
string
URL del profilo LinkedIn della persona.Nota: Ha la precedenza sulle informazioni individuali se entrambi sono forniti.
Opzione 2:
string
Nome della persona
string
Cognome della persona
string
Dominio dell’azienda (ad es. "dundermifflin.com")
string
Nome dell’azienda (alternativa a company_domain)
Aggiuntivo:
string
Un valore personalizzato che puoi utilizzare per fare riferimento a un ID interno. Sarà presente nei risultati.
object
Impostazioni relative a questa ricerca.

Risposta

201 — Ricerca singola creata

string
Messaggio di conferma
string
Identificatore univoco per questa ricerca. Utilizzalo per recuperare i risultati tramite l’endpoint GET.
number
Numero di crediti consumati (50 per impostazione predefinita; può variare in base al piano). Consulta Crediti e fatturazione per i costi per endpoint.
object
Dettaglio dei crediti

Risposte di errore

In caso di crediti insufficienti (402), il corpo della risposta è { "reason": "...", "success": false }. Consulta Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.

Prossimi passi

Ottieni il risultato

Recupera il numero di telefono trovato usando l’id della ricerca.

Trova telefoni in blocco

Esegui più ricerche di telefono in un’unica richiesta.

Autenticazione

Come passare la tua chiave API nell’header x-api-key.

Webhook

Ricevi una notifica automatica al completamento di una ricerca.