# Lookup – Übersicht

Lookup beantwortet Fragen über einen Empfänger, bevor Sie an ihn senden. Geben Sie eine Telefonnummer ein, und Lookup sagt Ihnen, was die Nummer ist: das zustellende Netz, das Land, ob die Nummer das Netz gewechselt hat und um welche Art von Anschluss es sich handelt. Geben Sie eine E-Mail-Adresse ein, und Lookup sagt Ihnen, ob sich der Versand an diese Adresse lohnt.

Beides ist eine Anfrage und eine Antwort. Sie müssen nichts anlegen, nichts abfragen und nichts aufräumen. Die [**Lookup**](https://bird.com/dashboard/w/lookup)-Seite im Dashboard führt dieselben beiden Operationen einzeln aus – der schnellste Weg, eine Antwort zu sehen, bevor Sie Code schreiben.

## Was jede Abfrage kostet

Jede Abfrage wird dem Guthaben Ihrer Organisation belastet, und genau das sollten Sie verstehen, bevor Sie darauf aufbauen.

Eine Telefonnummer-Abfrage wird immer einmal für die Basisabfrage berechnet. Zusätzlich können Sie **Properties** anfordern, weitere Fakten aus einer kostenpflichtigen Datenquelle. Jede angeforderte Property wird einzeln berechnet, aber **nur wenn sie geliefert wird**. Eine Property, die nicht beantwortet werden konnte, kommt mit einem Status zurück, der das anzeigt, und kostet Sie nichts.

Eine E-Mail-Adress-Abfrage wird einmal pro beantworteter Adresse berechnet. Jedes Ergebnis wird berechnet, `undeliverable` eingeschlossen: Das ist die Antwort, die Sie angefordert haben, und sie bewahrt Sie vor einem Bounce.

Nichts wird berechnet, wenn eine Abfrage fehlschlägt. Eine fehlerhafte Nummer, eine von uns abgelehnte Adresse oder eine nicht erreichbare Datenquelle kosten nichts.

[Lookup-Preise](/products/lookup/pricing) listet die Tarife für die Basisabfrage, für jede Property und für eine E-Mail-Adress-Abfrage auf.

## Die Nummernabfrage hat zwei Stufen

Diese Aufteilung ist das gesamte Design der Telefonnummer-Abfrage und verdient eine klare Erklärung.

Die **Basisabfrage** läuft immer. Sie liefert das zustellende Netz, das Netz, das die Nummer vergeben hat, das Land, ob die Nummer jemals das Netz gewechselt hat, und einen groben `line_type` (Mobilfunk, Festnetz, VoIP, gebührenfrei usw.). Kann die Basisabfrage nicht beantwortet werden, schlägt die gesamte Anfrage fehl, statt eine halb leere Antwort zurückzugeben, die Sie erst inspizieren müssten, um die Leere zu entdecken.

**Properties** sind das, was Sie darüber hinaus hinzufügen, indem Sie sie in `type` angeben. Sie beantworten feinere Fragen: den exakt zugewiesenen Dienst des Nummernbereichs, den vollständigen Portierungsverlauf, ob die Nummer gerade im Netz aktiv ist, ob sie roamt, wann die SIM zuletzt gewechselt wurde und einen Glaubwürdigkeitswert. Eine Property, die nicht beantwortet werden kann, lässt die Anfrage nie fehlschlagen. Sie fällt auf einen Status zurück, und die Basisabfrage wird weiterhin geliefert.

## Nur `ok` enthält einen Wert, und nur `ok` wird berechnet

Jeder Property-Block hat einen `status`, und ihn auszulesen ist nicht optional.

`ok` bedeutet, dass die Property beantwortet wurde, ihr Wert in der Antwort enthalten ist und sie berechnet wurde.

`unavailable` bedeutet, dass keine Antwort eintraf und die Property nichts beiträgt. Sie wurde nicht berechnet.

`inconclusive` bedeutet, dass eine Antwort eintraf, die Property aber nicht auflöst: Die Nummer liegt außerhalb der Abdeckung der dahinterliegenden Daten, oder die Quelle lieferte einen Wert, den diese Property nicht abbildet. Es ist ein echtes Ergebnis und kein fehlendes, und es wurde ebenfalls nicht berechnet.

`status` ist ein offenes Vokabular, weitere Werte können hinzukommen. Verzweigen Sie auf `ok` und behandeln Sie alles andere wie "not answered", dann bleibt Ihr Code korrekt, egal wie es sich erweitert.

## Lookup oder Validierung beim Senden

Lookup ist dafür da, **vor** dem Senden zu entscheiden, jeweils für einen Empfänger: eine Nummer oder Adresse bei der Registrierung prüfen, einen Lead screenen, bevor Sie darauf reagieren, oder eine Nachricht je nach Anschlussart anders routen. Es kostet Geld pro Prüfung und liefert Ihnen eine Antwort, auf die Sie handeln können.

Wenn Sie lediglich den Versand an Adressen stoppen wollen, die bereits gebounced haben oder sich beschwert haben, brauchen Sie Lookup nicht. [Suppressions](/docs/guides/email/suppressions) erledigen das automatisch und kostenlos.

Keine der beiden Operationen hat eine Batch-Variante, und die `lookup`-[Begrenzung der Anfragerate](/docs/guides/rate-limits) beginnt bei 10 Anfragen pro Minute pro Credential. Eine ganze Liste zu prüfen ist also nicht das, wofür der Dienst heute ausgelegt ist. Sprechen Sie uns an, wenn Sie ein höheres Limit benötigen.

## Nächste Schritte

- [Telefonnummer abfragen](/docs/guides/lookup/phone-numbers) behandelt die Basisabfrage, jede Property und was sie jeweils zurückgibt.
- [E-Mail-Adresse abfragen](/docs/guides/lookup/email-addresses) behandelt die Ergebnisse und was mit jedem davon zu tun ist.
- [Lookup-API-Referenz](/docs/api/reference/create-phone-number-lookup) dokumentiert jedes Feld.
- [Idempotenz](/docs/guides/idempotency) erklärt, wie Sie eine Abfrage erneut versuchen, ohne doppelt zu zahlen.

## Related resources

- [Phone number lookup: check a number before you send](/learn/lookup/phone-number-lookup-check-a-number-before-you-send) (video)
- [Lookup](/lookup-api) (product)

[Get an implementation brief](/learn/workspace?topic=lookup)