Zum Hauptinhalt springen
POST
/
phone
/
single
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'
{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}
POST
https://api.enrow.io/phone/single
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):
linkedin_url
string
LinkedIn-Profil-URL der Person.Hinweis: Hat Vorrang vor den einzelnen Informationen, falls beide angegeben werden.
Option 2:
firstname
string
Vorname der Person
lastname
string
Nachname der Person
company_domain
string
Unternehmensdomain (z. B. "dundermifflin.com")
company_name
string
Unternehmensname (Alternative zu company_domain)
Zusätzlich:
custom
string
Ein benutzerdefinierter Wert, den Sie verwenden können, um auf eine interne ID zu verweisen. Er wird in den Ergebnissen enthalten sein.
settings
object
Einstellungen für diese Suche.

Response

201 — Einzelsuche erstellt

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

Error Responses

CodeMessage
400Invalid linkedin_url format
401No apikey found in the x-api-key headers
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
Bei unzureichenden Credits (402) lautet der Antwort-Body { "reason": "...", "success": false }. Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'
{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}

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.