Trova email in blocco

curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

{
  "message": "..."
}

POST

find

bulk

curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

{
  "message": "..."
}

POST

https://api.enrow.io/email/find/bulk

Esegui più ricerche di email in un’unica richiesta. Fino a 5.000 ricerche per batch. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. Per trovare una singola email, usa invece l’endpoint Find Single Email.

Enrow esegue verifiche deterministiche che verificano anche le email catch-all. Nessun debouncer necessario.

Corpo della richiesta

array of objects

obbligatorio

Payload di ricerca per i quali trovare le email corrispondenti.

Mostra proprietà dell'oggetto search

string

obbligatorio

Il nome completo dell’utente

string

Il dominio dell’azienda o l’URL del sito web. È richiesto company_domain oppure company_name.

string

Il nome dell’azienda dell’utente. È richiesto company_domain oppure company_name.

string | object

Un valore personalizzato che puoi utilizzare per fare riferimento a un ID interno (ad esempio). Sarà presente nei risultati.

object

Parametri personalizzati che verranno restituiti nella risposta GET e nella notifica webhook.

Mostra oggetto custom

string

predefinito:"your_custom_property"

I tuoi dati personalizzati

object

Impostazioni relative all’intera ricerca in blocco.

Mostra proprietà di settings

string

predefinito:"US"

Un codice di 2 caratteri che rappresenta il paese delle ricerche (codice ISO 3166 Alpha-2). Rilevante quando si utilizza company_name.

string

Un URL che verrà notificato tramite una richiesta HTTP POST una volta terminata la ricerca in blocco. Vedi Come funzionano i webhook.

boolean

predefinito:"false"

Ottieni il genere associato quando viene trovata un’email.

boolean

predefinito:"false"

Ottieni le informazioni aziendali associate. Efficace solo quando country_code è FR.

Risposta

201 — Ricerca in blocco avviata

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)

Risposte di errore

Code	Message
400	`Missing payload`
400	`Missing searches payload`
400	`Too many searches. Limit is currently at 5000 per batch.`
400	`Error while parsing payload`
401	`No apikey found in the x-api-key headers`
401	`This apikey is not valid`
402	`Insufficient credits`

In caso di crediti insufficienti, l’endpoint bulk restituisce HTTP 402 con un corpo nella forma { "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/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

{
  "message": "..."
}

Prossimi passi

Ottieni i risultati in blocco

Recupera le email trovate usando l’id del batch.

Trova una singola email

Esegui una singola ricerca di email a partire da un nome e un’azienda.

Webhook

Ricevi notifiche automatiche al completamento di un batch.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.

Per iniziare

Email Finder

Email Verifier

Phone Finder

Account

Corpo della richiesta

Risposta

201 — Ricerca in blocco avviata

Risposte di errore

Prossimi passi

Ottieni i risultati in blocco

Trova una singola email

Webhook

Crediti e fatturazione

​Corpo della richiesta

​Risposta

​201 — Ricerca in blocco avviata

​Risposte di errore

​Prossimi passi

Ottieni i risultati in blocco

Trova una singola email

Webhook

Crediti e fatturazione

Corpo della richiesta

Risposta

201 — Ricerca in blocco avviata

Risposte di errore

Prossimi passi