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

# Enrow API

> Überblick über die Enrow API zum Finden und Verifizieren professioneller E-Mail-Adressen und Telefonnummern in großem Umfang, mit asynchronen Suchen, Webhooks und Massenverarbeitung

Mit der Enrow API finden und verifizieren Sie professionelle Kontaktdaten in großem Umfang. Jede Anfrage wird mit einem [API-Schlüssel](/de/authentication) im `x-api-key`-Header authentifiziert, und jede Suche läuft asynchron, sodass Sie große Mengen ohne Blockierung verarbeiten können.

<Note>
  **Basis-URL** — Alle API-Anfragen gehen an `https://api.enrow.io`
</Note>

## Was kann ich mit der Enrow API machen?

Die Enrow API stellt drei Kernfunktionen bereit, die jeweils im Einzel- und im Massenmodus verfügbar sind:

<CardGroup cols={2}>
  <Card title="Email Finder" icon="envelope" href="/de/api-reference/email-finder/find-single">
    Finden Sie professionelle E-Mail-Adressen anhand eines Namens und einer Unternehmensdomain
  </Card>

  <Card title="Email Verifier" icon="shield-check" href="/de/api-reference/email-verifier/verify-single">
    Verifizieren Sie jede E-Mail-Adresse mit deterministischer Catch-all-Verifizierung
  </Card>

  <Card title="Phone Finder" icon="phone" href="/de/api-reference/phone/find-single">
    Finden Sie Durchwahlnummern anhand einer LinkedIn-URL oder eines Namens + Unternehmens
  </Card>
</CardGroup>

## Wie funktioniert die Enrow API?

Alle Endpunkte sind **asynchron** und folgen demselben Muster: Sie übermitteln eine Suche und holen das Ergebnis anschließend per Webhook oder Polling ab.

<Steps>
  <Step title="Senden Sie Ihre Anfrage per POST">
    Senden Sie Ihre Suchparameter. Sie erhalten sofort eine eindeutige Such-ID.
  </Step>

  <Step title="Benachrichtigung erhalten oder pollen">
    **Webhook (empfohlen):** Übergeben Sie eine `webhook`-URL in `settings`, und das Ergebnis wird sofort per POST an Ihren Server gesendet. Siehe [Wie Webhooks funktionieren](/de/how-webhooks-work).

    **Polling:** Rufen Sie den GET-Endpunkt mit der Such-ID auf.
  </Step>

  <Step title="Das Ergebnis nutzen">
    Das Feld `qualification` gibt an, ob das Ergebnis `valid`, `invalid`, `found` oder `not_found` ist.
  </Step>
</Steps>

## Wie stelle ich meine erste Anfrage?

Authentifizieren Sie sich mit Ihrem API-Schlüssel im `x-api-key`-Header und senden Sie eine Suche per POST an den entsprechenden Endpunkt. Das folgende Beispiel führt eine einzelne E-Mail-Suche aus:

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST https://api.enrow.io/email/find/single \
      -H "x-api-key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com"
      }'
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    const response = await fetch('https://api.enrow.io/email/find/single', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': process.env.ENROW_API_KEY
      },
      body: JSON.stringify({
        fullname: 'Dwight Schrute',
        company_domain: 'dundermifflin.com'
      })
    });

    const data = await response.json();
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests, os

    response = requests.post(
        "https://api.enrow.io/email/find/single",
        headers={"x-api-key": os.getenv("ENROW_API_KEY")},
        json={
            "fullname": "Dwight Schrute",
            "company_domain": "dundermifflin.com"
        }
    )
    print(response.json())
    ```
  </Tab>
</Tabs>

**Antwort:**

```json theme={null}
{
  "message": "Single search operating",
  "id": "910f3e13-b2bf-442d-ab0b-4cf44d...",
  "credits_used": 1
}
```

Der POST-Aufruf ist asynchron — `email` und `qualification` werden später über den [GET-Endpunkt](/de/api-reference/email-finder/get-single-result) oder einen [Webhook](/de/how-webhooks-work) abgerufen.

## Sollte ich den Einzel- oder den Massenmodus verwenden?

Verwenden Sie den Einzelmodus für Echtzeit-Einzelabfragen und den Massenmodus für umfangreiche Anreicherung. Jeder Endpunkt unterstützt beides:

|                            | Einzeln                           | Masse                            |
| -------------------------- | --------------------------------- | -------------------------------- |
| **Batch-Größe**            | 1                                 | Bis zu 5.000 (3.000 für Telefon) |
| **Am besten geeignet für** | Echtzeit-Abfragen                 | Anreicherung in großem Umfang    |
| **Webhook**                | Vollständiges Ergebnis im Payload | Benachrichtigung, dann GET       |

Für Massenaufträge siehe [E-Mails finden](/de/api-reference/email-finder/find-bulk), [E-Mails verifizieren](/de/api-reference/email-verifier/verify-bulk) und [Telefonnummern finden](/de/api-reference/phone/find-bulk).

## Was unterscheidet die Enrow API?

Die Enrow API kombiniert deterministische Verifizierung mit flexibler Ergebnisbereitstellung, sodass Sie ohne zusätzliche Werkzeuge präzise Daten erhalten:

<CardGroup cols={2}>
  <Card title="Catch-all-Verifizierung" icon="check-double">
    Deterministische Verifizierung, die selbst bei Catch-all-Domains funktioniert. Kein Debouncer erforderlich.
  </Card>

  <Card title="Benutzerdefinierte Felder" icon="tag">
    Übergeben Sie Ihre eigenen `custom`-Daten mit jeder Suche — sie werden unverändert im Ergebnis zurückgegeben.
  </Card>
</CardGroup>

<Card title="Webhooks" icon="bolt" href="/de/how-webhooks-work">
  Erhalten Sie Ergebnisse in Echtzeit. Kein Polling, keine verschwendeten API-Aufrufe.
</Card>

## FAQ

<AccordionGroup>
  <Accordion title="Wie authentifiziere ich API-Anfragen?">
    Jede Anfrage muss Ihren API-Schlüssel im `x-api-key`-Header enthalten — es gibt keine OAuth-Flows oder Bearer-Tokens. Siehe [Authentifizierung](/de/authentication) für Einrichtung und Beispiele.
  </Accordion>

  <Accordion title="Warum sind die Antworten asynchron?">
    Eine POST-Anfrage startet eine Suche und gibt sofort eine eindeutige `id` zurück. `email`, `phone` oder `qualification` werden später über einen [Webhook](/de/how-webhooks-work) oder durch Polling des passenden GET-Endpunkts mit dieser `id` bereitgestellt.
  </Accordion>

  <Accordion title="Wie viele Suchen kann ich in einer Massenanfrage ausführen?">
    Massenanfragen für E-Mails und E-Mail-Verifizierung akzeptieren bis zu 5.000 Suchen, und Massenanfragen für Telefonnummern akzeptieren bis zu 3.000. Bei Einzelanfragen beträgt die Batch-Größe 1.
  </Accordion>

  <Accordion title="Wie werden Credits verbraucht?">
    Credits werden pro Suche abgezogen, und die Menge wird in `credits_used` zurückgegeben. Siehe [Credits & Abrechnung](/de/credits-billing) für die Kosten pro Endpunkt und [Rate-Limits](/de/rate-limits), bevor Sie skalieren.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Authentifizierung" icon="key" href="/de/authentication">
    Richten Sie Ihren API-Schlüssel im x-api-key-Header ein
  </Card>

  <Card title="Wie Webhooks funktionieren" icon="bolt" href="/de/how-webhooks-work">
    Erhalten Sie Ergebnisse in Echtzeit, ohne Polling
  </Card>

  <Card title="Credits & Abrechnung" icon="coins" href="/de/credits-billing">
    Verstehen Sie, wie Credits pro Endpunkt verbraucht werden
  </Card>

  <Card title="Fehlerbehandlung" icon="circle-info" href="/de/error-handling">
    Statuscodes, Qualifikationen und Fehlerformate
  </Card>
</CardGroup>