Naar hoofdinhoud gaan
POST
/
email
/
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
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}
POST 
https://api.enrow.io/email/find/bulk
Voer meerdere e-mailzoekopdrachten uit in één verzoek. Tot 5.000 zoekopdrachten per batch. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header. Gebruik het endpoint E-mail vinden om in plaats daarvan één e-mailadres te vinden.
Enrow voert deterministische verificaties uit die zelfs catch-all-e-mails verifiëren. Geen debouncer nodig.

​
Request Body

​
searches
array of objects
vereist
Zoekpayloads waarvoor bijbehorende e-mails moeten worden gevonden.
​
custom
object
Aangepaste parameters die worden teruggegeven in de GET-respons en in de webhookmelding.
​
settings
object
Instellingen die betrekking hebben op de volledige bulkzoekopdracht.

​
Response

​
201 — Bulkzoekopdracht gestart

​
message
string
Bevestigingsbericht
​
id
string
Unieke identificatie voor deze batch. Gebruik dit om resultaten op te halen via het GET-endpoint.
​
credits_used
number
Totaal aantal verbruikte credits. Zie Credits en facturering voor de kosten per endpoint.
​
estimated_duration
number
Geschatte verwerkingstijd in minuten (niet gegarandeerd)

​
Foutresponsen

CodeMessage
400Missing payload
400Missing searches payload
400Too many searches. Limit is currently at 5000 per batch.
400Error while parsing payload
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
Bij onvoldoende credits geeft het bulk-endpoint HTTP 402 terug met een body van de vorm { "message": "..." }. Zie Foutafhandeling voor de volledige lijst met statuscodes en responseformaten.
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
    }
  }'

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

​
Volgende stappen

Bulkresultaten ophalen

Haal de gevonden e-mails op met de batch-id.

Eén e-mail vinden

Voer één e-mailzoekopdracht uit op basis van een naam en bedrijf.

Webhooks

Word automatisch op de hoogte gebracht wanneer een batch is voltooid.

Credits en facturering

Bekijk hoe credits worden verbruikt voor elk endpoint.