> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.
# E-Mails finden
> Finden Sie professionelle E-Mail-Adressen im Stapel anhand von Namen und Unternehmen — bis zu 5.000 Suchen pro Batch mit Enrow Email Finder
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](/de/authentication) im `x-api-key`-Header. Um stattdessen eine einzelne E-Mail zu finden, verwenden Sie den Endpunkt [Einzelne E-Mail finden](/de/api-reference/email-finder/find-single).
Enrow führt **deterministische Verifizierungen** durch, die selbst Catch-all-E-Mails verifizieren. Kein Debouncer erforderlich.
## Request Body
Such-Payloads, für die die zugehörigen E-Mails gefunden werden sollen.
Der vollständige Name des Nutzers
Die Unternehmensdomain oder Website-URL. Entweder `company_domain` oder `company_name` ist erforderlich.
Der Name des Unternehmens des Nutzers. Entweder `company_domain` oder `company_name` ist erforderlich.
Ein benutzerdefinierter Wert, mit dem Sie beispielsweise eine interne ID referenzieren können. Er wird in den Ergebnissen enthalten sein.
Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.
Ihre benutzerdefinierten Daten
Einstellungen, die sich auf die gesamte Stapelsuche beziehen.
Ein 2-stelliger Code, der das Land der Suchen repräsentiert (ISO 3166 Alpha-2-Code). Relevant bei Verwendung von `company_name`.
Eine URL, die über eine HTTP-POST-Anfrage benachrichtigt wird, sobald die Stapelsuche abgeschlossen ist. Siehe [Wie Webhooks funktionieren](/de/how-webhooks-work).
Ruft das zugehörige Geschlecht ab, wenn eine E-Mail gefunden wird.
Ruft die zugehörigen Unternehmensinformationen ab. Nur wirksam, wenn `country_code` `FR` ist.
## Response
### 201 — Stapelsuche gestartet
Bestätigungsnachricht
Eindeutige Kennung für diesen Batch. Verwenden Sie diese, um Ergebnisse über den [GET-Endpunkt](/de/api-reference/email-finder/get-bulk-results) abzurufen.
Insgesamt verbrauchte Credits. Siehe [Credits & Abrechnung](/de/credits-billing) für die Kosten pro Endpunkt.
Geschätzte Verarbeitungszeit in Minuten (nicht garantiert)
### Error Responses
| 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` |
Bei unzureichenden Credits gibt der Stapel-Endpunkt HTTP **402** mit einem Body der Form `{ "message": "..." }` zurück. Siehe [Fehlerbehandlung](/de/error-handling) für die vollständige Liste der Statuscodes und Antwortformate.
```bash cURL theme={null}
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
}
}'
```
```javascript Node.js theme={null}
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}`);
```
```python Python theme={null}
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())
```
```json Success Response theme={null}
{
"message": "Bulk search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 3,
"estimated_duration": 1
}
```
```json Error Response theme={null}
{
"message": "..."
}
```
## Nächste Schritte
Rufen Sie die gefundenen E-Mails anhand der Batch-`id` ab.
Führen Sie eine einzelne E-Mail-Suche anhand eines Namens und Unternehmens aus.
Lassen Sie sich automatisch benachrichtigen, wenn ein Batch abgeschlossen ist.
Erfahren Sie, wie Credits für jeden Endpunkt verbraucht werden.