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
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);answer = client.lookup.email(email="aisha.khan@example.com")
# result is an open vocabulary; delivery_confidence is always comparable.
print(answer.result, answer.delivery_confidence)answer, err := client.Lookup.Email(context.Background(), bird.LookupEmailParams{
Email: "aisha.khan@example.com",
})
if err != nil {
log.Fatal(err)
}
// result is an open vocabulary; delivery_confidence is always comparable.
fmt.Println(*answer.Result, *answer.DeliveryConfidence)$answer = $bird->lookup->email(
(new EmailLookupRequest())->setEmail('aisha.khan@example.com'),
);
// result is an open vocabulary; delivery_confidence is always comparable.
echo $answer->getResult(), ' ', $answer->getDeliveryConfidence();bird lookup email --email aisha.khan@example.comcurl -X POST "https://us1.platform.bird.com/v1/lookup/email" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "aisha.khan@example.com"
}'Einen Batch nachschlagen
Verwenden Sie POST /v1/lookup/email/batch, um bis zu 1.000 Adressen in einer Anfrage zu prüfen:
Codebeispiel
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 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.
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 <aisha@example.com> 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.
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 | 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 | 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 | Die Abfrage ist vorübergehend nicht verfügbar. Versuchen Sie es mit Backoff erneut. Es wurde nichts berechnet. |
Nächste Schritte
- Telefonnummer nachschlagen ist die andere Hälfte von Lookup.
- Suppressions verhindern wiederholte Sendungen an Adressen, die bereits gebounct haben, ohne zusätzliche Kosten.
- Lookup-API-Referenz dokumentiert jedes Feld.
- E-Mail-Lookup: Nimmt diese Adresse tatsächlich E-Mails an ist ein Video, das Abfragen gegen eine Rollenadresse, einen Tippfehler und einen Free-Provider durchführt.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.