Skip to main content
GET
GET
Rufen Sie das Ergebnis einer zuvor gestarteten E-Mail-Suche anhand ihrer eindeutigen ID ab. Authentifizieren Sie jede Anfrage mit Ihrem API-Schlüssel im Header x-api-key.
Mit einem Webhook können Sie den Aufruf dieses GET-Endpunkts überspringen, da Sie in dem Moment benachrichtigt werden, in dem Ihre Suche abgeschlossen ist. Siehe So funktionieren Webhooks.

Query-Parameter

string
erforderlich
Der eindeutige Bezeichner, der von der POST-Anfrage zurückgegeben wurde

Antwort

200 — Suche abgeschlossen

string
Die gefundene E-Mail-Adresse
string
valid (E-Mail gefunden) oder invalid (E-Mail nicht gefunden). Warum binär?
number
Endgültige Kosten der Suche nach Erstattungen: 1 für eine gefundene E-Mail, 0 für eine nicht gefundene E-Mail (0.25 für eine Suche anhand einer LinkedIn-Profil-URL oder für ein Konto mit ungewöhnlich niedriger Erfolgsquote, siehe Credits & Abrechnung). Eine Suche anhand einer LinkedIn-Profil-URL, die wegen eines Problems auf unserer Seite fehlschlägt, kostet 0: siehe Ergebnisse einer Suche anhand einer LinkedIn-Profil-URL.
object
Kontakt- und Unternehmensinformationen. Bei einer Suche anhand einer LinkedIn-Profil-URL nur vorhanden, wenn eine E-Mail gefunden wird.
object
Benutzerdefinierte Eigenschaften, die in der ursprünglichen Anfrage übergeben wurden, unverändert zurückgegeben
string
Nur bei einer Suche anhand einer LinkedIn-Profil-URL. Wie die Suche ausgegangen ist: found, profile_not_found, no_current_company, email_not_found oder lookup_failed. Siehe Ergebnisse einer Suche anhand einer LinkedIn-Profil-URL.
string
Nur bei einer Suche anhand einer LinkedIn-Profil-URL. Die von Ihnen gesendete linkedin_url.

202 — Suche läuft noch

string
ongoing — die Suche ist noch nicht abgeschlossen. Fragen Sie in Kürze erneut ab oder verwenden Sie einen Webhook, um automatisch benachrichtigt zu werden. Das Abrufen eines Ergebnisses verbraucht keine Credits; siehe Credits & Abrechnung.

Fehlerantworten

Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.

Ergebnisse einer Suche anhand einer LinkedIn-Profil-URL

Eine anhand einer LinkedIn-Profil-URL gestartete Suche behält die binäre qualification und ergänzt zwei Felder: linkedin_status, das angibt, wie die Suche ausgegangen ist, und linkedin_url, die von Ihnen gesendete URL. Wird die E-Mail gefunden, liefert info den Namen und das Unternehmen aus dem Profil: firstname, lastname, company_name und company_domain, dazu gender, wenn retrieve_gender auf true gesetzt ist. In allen anderen Fällen enthält die Antwort weder email noch info und verrät somit nie, wem das Profil gehört. Steht die E-Mail oder das Profil auf Ihrer Ausschlussliste, wird die gefundene E-Mail zurückgehalten: Das Ergebnis lautet email_not_found und kostet 1 Credit, wie eine gefundene E-Mail. Solange die Suche läuft, gibt der Endpunkt wie gewohnt 202 mit qualification: "ongoing" zurück.

Nächste Schritte

E-Mail finden

Starten Sie eine einzelne E-Mail-Suche, um eine Such-id zu erhalten.

Bulk-Ergebnisse abrufen

Rufen Sie die Ergebnisse einer Bulk-E-Mail-Suche ab.

Webhooks

Lassen Sie sich automatisch benachrichtigen, wenn eine Suche abgeschlossen ist.

Authentifizierung

So übergeben Sie Ihren API-Schlüssel im x-api-key-Header.