# E-Mail-Adresse nachschlagen Ein einziger Aufruf sagt Ihnen, ob eine Adresse E-Mails annimmt. Nutzen Sie ihn bei der Registrierung oder bevor Sie auf einen Lead reagieren, damit Adressen, die einen Bounce verursachen würden, gar nicht erst in Ihren Versand gelangen. Alles hier erfordert einen API-Schlüssel mit dem Scope `lookup`. ## Eine Adresse nachschlagen **TypeScript** ```typescript const answer = await bird.lookup.email({ email: "aisha.khan@example.com" }); // result is an open vocabulary; delivery_confidence is always comparable. console.log(answer.result, answer.delivery_confidence); ``` Examples: [TypeScript](/de-de/dokumentation/guides/lookup/email-addresses.ts.md) · [Python](/de-de/dokumentation/guides/lookup/email-addresses.py.md) · [Go](/de-de/dokumentation/guides/lookup/email-addresses.go.md) · [PHP](/de-de/dokumentation/guides/lookup/email-addresses.php.md) · [CLI](/de-de/dokumentation/guides/lookup/email-addresses.cli.md) · [MCP](/de-de/dokumentation/guides/lookup/email-addresses.mcp.md) · [cURL](/de-de/dokumentation/guides/lookup/email-addresses.curl.md) ## Einen Batch nachschlagen Verwenden Sie `POST /v1/lookup/email/batch`, um bis zu 1.000 Adressen in einer Anfrage zu prüfen: ```bash curl -X POST "https://us1.platform.bird.com/v1/lookup/email/batch" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"emails":["aisha.khan@example.com","not-an-email"]}' ``` Das `data`-Array in der Antwort enthält eine Bewertung pro Eingabe, in der Reihenfolge der Übermittlung. Fehlerhafte Adressen erhalten individuelle Bewertungen. Doppelte Adressen bleiben separate Einträge, und jeder beantwortete Eintrag wird abgerechnet. Umgebende Leerzeichen werden entfernt, die Groß-/Kleinschreibung bleibt erhalten. Halten Sie jede Anfrage unter 128 KiB. Teilen Sie größere Listen in separate Batches auf. Wenn Sie [idempotente Wiederholungen](/docs/guides/idempotency) nutzen, verwenden Sie für jeden Batch einen eigenen Schlüssel. Antworten bis 256 KiB können für eine Wiedergabe gespeichert werden; größere Antworten werden ohne Wiedergabeschutz zurückgegeben, sodass ein erneuter Versuch einen weiteren Batch ausführen und berechnen kann. Siehe die [Batch-API-Referenz](/docs/api/reference/create-email-lookup-batch). ## So geben Sie die Adresse an Senden Sie eine reine Adresse, genau so, wie Sie sie gespeichert haben. Eine Einzeladress-Abfrage lehnt Display-Name-Formen wie `Aisha ` ab, anstatt sie zu entpacken. Batch-Abfragen geben für jeden übermittelten String eine Bewertung zurück. Der Teil vor dem `@` wird so übernommen, wie er geschrieben wurde, ohne ihn in Kleinbuchstaben umzuwandeln, und das Feld `email` bewahrt diese Schreibweise. Batch-Antworten entfernen umgebende Leerzeichen; ordnen Sie jedes Ergebnis dem Eingabewert an derselben Position zu. Senden Sie die Adresse in der Schreibweise, in der Sie sie gespeichert haben, anstatt sie vorher zu normalisieren: `result` ist in der Regel in beiden Fällen gleich, aber `delivery_confidence` ist nicht immer identisch, sodass eine Änderung der Schreibweise die Antwort verändern kann. ## Die fünf Bewertungen `result` ist das Feld, auf dessen Basis Sie entscheiden. `valid`: Die Adresse existiert und nimmt E-Mails an. Senden. `neutral`: Es konnte weder bestätigt noch widerlegt werden, meist weil die empfangende Domain jeden Empfänger gleich beantwortet. Senden ist vertretbar; eine neutrale Adresse ist keine schlechte Adresse, sondern eine unbeantwortbare. `risky`: Die Adresse nimmt wahrscheinlich E-Mails an, hat aber ein höheres Risiko für Bounces oder Beschwerden als die meisten anderen. Rollenadressen, Wegwerfadressen und Adressen mit niedriger Reputation landen hier. Ob Sie senden, hängt von Ihrer eigenen Toleranz gegenüber Beschwerden ab, und `flags` sagt Ihnen, um welche Art von Risiko es sich handelt. `undeliverable`: Die Adresse nimmt keine E-Mails an. Nicht senden. `reason` gibt den Grund an: `invalid_syntax` bei einer fehlerhaften Adresse, `invalid_domain` wenn die Domain überhaupt keine E-Mails annimmt, `invalid_recipient` wenn die Domain E-Mails annimmt, dieses Postfach aber nicht existiert. `typo`: Die Adresse sieht falsch geschrieben aus, und `did_you_mean` enthält die Korrektur. Bieten Sie die Korrektur der Person an, die das Original eingegeben hat, anstatt ungefragt dorthin zu senden: Es ist eine Vermutung, und die gemeinte Adresse könnte keine von beiden sein. `result` ist ein offenes Vokabular, daher ist ein Ihnen unbekannter Wert eine zukünftige Bewertung und kein Fehler. Verzweigen Sie auf die Werte, die Sie kennen, und fallen Sie auf `delivery_confidence` zurück, das immer vorhanden und immer vergleichbar ist. ## Konfidenz zusammen mit der Bewertung lesen, nicht anstelle davon `delivery_confidence` reicht von 0 (sicher nicht zustellbar) bis 100 (sicher zustellbar). Derselbe Wert kann aus unterschiedlichen Gründen unter `neutral` oder `risky` liegen, daher ist er eine zweite Meinung und kein Ersatz für `result`. Es ist das Feld, auf das Sie sich stützen, wenn Sie einen einzigen Schwellenwert über alle Bewertungen hinweg wollen, einschließlich zukünftig hinzukommender. `valid` enthält die Gültigkeitsbewertung des Providers. Ein ungültiger Empfänger kann `valid: false` haben, selbst wenn seine Domain E-Mails annimmt. Verwenden Sie `result` und `delivery_confidence` zusammen, um über den Versand zu entscheiden; `valid: true` garantiert keine Zustellung. ## Flags beschreiben die Art der Adresse `flags` ist leer, wenn nichts Auffälliges zutrifft. Drei Werte sind definiert, und es ist eine offene Liste. `role` bedeutet, dass die Adresse eine Funktion statt einer Person benennt, z. B. `support@` oder `info@`. Antworten und Einwilligungen sind mehrdeutig, und Beschwerden sind wahrscheinlicher. `disposable` bedeutet, dass die Adresse zu einem Wegwerfadressen-Anbieter gehört und daher typischerweise aufhören wird zu existieren. `free_provider` bedeutet, dass die Adresse zu einem Consumer-Mailbox-Anbieter wie Gmail oder Outlook.com gehört. Das ist für Consumer-E-Mails normal und nur dann ein Signal, wenn Sie eine Geschäftsadresse erwartet haben. ## Erneut versuchen, ohne doppelt zu zahlen Jede beantwortete Adresse wird abgerechnet, einschließlich `undeliverable`, denn das ist die Antwort, für die Sie bezahlt haben, und der Bounce, den Sie vermieden haben. Senden Sie einen `Idempotency-Key`, damit ein erneuter Versuch die gespeicherte Bewertung wiedergibt, anstatt eine zweite zu kaufen. Siehe [Idempotenz](/docs/guides/idempotency). Die `GET`-Form, die die Adresse in die URL setzt, kann keinen Idempotenz-Schlüssel mitführen. Verwenden Sie die `POST`-Form für alles Automatisierte. ## Fehler | Code | Was passiert ist | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`E22003`](/docs/api/errors/E22003) | Eine Einzeladress-Abfrage hat eine ungültige E-Mail-Adresse erhalten. Es wurde nichts berechnet. Batch-Abfragen bewerten fehlerhafte Strings einzeln und berechnen diese Bewertungen. | | [`E22001`](/docs/api/errors/E22001) | Das Guthaben der Organisation reicht für die Abfrage nicht aus. Laden Sie es auf und versuchen Sie es erneut. Es wurde nichts berechnet. | | [`E22002`](/docs/api/errors/E22002) | Die Abfrage ist vorübergehend nicht verfügbar. Versuchen Sie es mit Backoff erneut. Es wurde nichts berechnet. | ## Nächste Schritte - [Telefonnummer nachschlagen](/docs/guides/lookup/phone-numbers) ist die andere Hälfte von Lookup. - [Suppressions](/docs/guides/email/suppressions) verhindern wiederholte Sendungen an Adressen, die bereits gebounct haben, ohne zusätzliche Kosten. - [Lookup-API-Referenz](/docs/api/reference/create-email-lookup) dokumentiert jedes Feld. - [E-Mail-Lookup: Nimmt diese Adresse tatsächlich E-Mails an](/learn/lookup/email-lookup-will-that-address-actually-accept-mail) ist ein Video, das Abfragen gegen eine Rollenadresse, einen Tippfehler und einen Free-Provider durchführt. ## Related resources - [What are bounced emails?](/explained/deliverability/what-are-bounced-emails) (answer) - [Email lookup](/lookup-api) (product) [Get an implementation brief](/learn/workspace?topic=lookup-email)