Vai al contenuto principale
POST
/
phone
/
bulk
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}
POST 
https://api.enrow.io/phone/bulk
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

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

​
Response

​
201 — Ricerca in batch creata

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

​
Risposte di errore

CodeMessage
400At least 1 phone search must be present in the payload
400Missing payload
400Too many searches. Limit is currently at 3000 per batch.
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
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.
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}

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