Zum Hauptinhalt springen
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
Führen Sie mehrere E-Mail-Suchen in einer einzigen Anfrage aus. Bis zu 5.000 Suchen pro Batch. Authentifizieren Sie jede Anfrage mit Ihrem API-Schlüssel im x-api-key-Header. Um stattdessen eine einzelne E-Mail zu finden, verwenden Sie den Endpunkt Einzelne E-Mail finden.
Enrow führt deterministische Verifizierungen durch, die selbst Catch-all-E-Mails verifizieren. Kein Debouncer erforderlich.

Request Body

searches
array of objects
erforderlich
Such-Payloads, für die die zugehörigen E-Mails gefunden werden sollen.
custom
object
Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.
settings
object
Einstellungen, die sich auf die gesamte Stapelsuche beziehen.

Response

201 — Stapelsuche gestartet

message
string
Bestätigungsnachricht
id
string
Eindeutige Kennung für diesen Batch. Verwenden Sie diese, um Ergebnisse über den GET-Endpunkt abzurufen.
credits_used
number
Insgesamt verbrauchte Credits. Siehe Credits & Abrechnung für die Kosten pro Endpunkt.
estimated_duration
number
Geschätzte Verarbeitungszeit in Minuten (nicht garantiert)

Error Responses

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
Bei unzureichenden Credits gibt der Stapel-Endpunkt HTTP 402 mit einem Body der Form { "message": "..." } zurück. Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.
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
}

Nächste Schritte

Stapelergebnisse abrufen

Rufen Sie die gefundenen E-Mails anhand der Batch-id ab.

Einzelne E-Mail finden

Führen Sie eine einzelne E-Mail-Suche anhand eines Namens und Unternehmens aus.

Webhooks

Lassen Sie sich automatisch benachrichtigen, wenn ein Batch abgeschlossen ist.

Credits & Abrechnung

Erfahren Sie, wie Credits für jeden Endpunkt verbraucht werden.