Skip to main content
POST
POST
Esegui più ricerche di numeri di telefono in un’unica richiesta. Fino a 3.000 ricerche per batch. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. Per trovare un singolo numero di telefono, usa l’endpoint Trova Telefono. Ogni ricerca deve contenere uno tra:
  • L’URL del profilo LinkedIn di una persona (ad esempio, https://www.linkedin.com/in/michael-scott/)
  • La combinazione di informazioni individuali: firstname + lastname + (company_name o company_domain)
L’URL LinkedIn avrà sempre la precedenza sulle informazioni individuali se entrambi sono presenti.

Request Body

array of objects
obbligatorio
Payload di ricerca per i quali trovare i numeri di telefono corrispondenti.
object
Parametri personalizzati che verranno restituiti nella risposta GET e nella notifica webhook.
object
Impostazioni relative all’intera ricerca in batch.

Response

201 — Ricerca in batch creata

string
Messaggio di conferma
string
Identificatore univoco per questo batch. Usalo per recuperare i risultati tramite l’endpoint GET.
number
Crediti totali consumati. Vedi Crediti e fatturazione per i costi per endpoint.
number
Tempo di elaborazione stimato in minuti (non garantito)
object
Dettaglio dei crediti

Risposte di errore

Quando i crediti sono insufficienti, l’endpoint in batch restituisce HTTP 402 con un corpo nel formato { "message": "..." }. Vedi Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.

Passaggi successivi

Ottieni risultati batch

Recupera i numeri di telefono trovati usando l’id del batch.

Trova un singolo telefono

Esegui una singola ricerca di telefono da un URL LinkedIn oppure nome e azienda.

Webhook

Ricevi una notifica automatica al completamento di una ricerca in batch.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.