Skip to main content
POST
POST
Führen Sie eine asynchrone Suche aus, um eine Telefonnummer und das zugehörige Land zu finden. Authentifizieren Sie jede Anfrage mit Ihrem API-Schlüssel im x-api-key-Header. Die Suche muss eines der folgenden Elemente enthalten:
  • Die URL des LinkedIn-Profils einer Person (z. B. https://www.linkedin.com/in/michael-scott/)
  • Die Kombination einzelner Informationen: firstname + lastname + (company_name oder company_domain)
Die LinkedIn-URL hat immer Vorrang vor den einzelnen Informationen, falls beide vorhanden sind, da sie die beste Möglichkeit ist, eine einzelne Person eindeutig zu bestimmen und Probleme durch Namensgleichheit zu vermeiden.

Request Body

Option 1 (Empfohlen):
string
LinkedIn-Profil-URL der Person.Hinweis: Hat Vorrang vor den einzelnen Informationen, falls beide angegeben werden.
Option 2:
string
Vorname der Person
string
Nachname der Person
string
Unternehmensdomain (z. B. "dundermifflin.com")
string
Unternehmensname (Alternative zu company_domain)
Zusätzlich:
string
Ein benutzerdefinierter Wert, den Sie verwenden können, um auf eine interne ID zu verweisen. Er wird in den Ergebnissen enthalten sein.
object
Einstellungen für diese Suche.

Response

201 — Einzelsuche erstellt

string
Bestätigungsnachricht
string
Eindeutiger Bezeichner für diese Suche. Verwenden Sie ihn, um die Ergebnisse über den GET-Endpunkt abzurufen.
number
Anzahl der verbrauchten Credits (standardmäßig 50; kann je nach Tarif variieren). Siehe Credits & Abrechnung für die Kosten pro Endpunkt.
object
Credit-Aufschlüsselung

Error Responses

Bei unzureichenden Credits (402) lautet der Antwort-Body { "reason": "...", "success": false }. Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.

Nächste Schritte

Ergebnis abrufen

Rufen Sie die gefundene Telefonnummer anhand der Such-id ab.

Telefonnummern im Bulk finden

Führen Sie mehrere Telefonsuchen in einer einzigen Anfrage aus.

Authentifizierung

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

Webhooks

Werden Sie automatisch benachrichtigt, wenn eine Suche abgeschlossen ist.