Provider-verifizierte Handynummern bekommen

linkedin_to_mobile_phone ist der einzige Telefon-Endpunkt der API. Er nimmt ein LinkedIn-Profil entgegen und gibt eine provider-verifizierte Handynummer zurück, zusammen mit dem Datum, an dem sie zuletzt verifiziert wurde.

{
  "mobile_phone": "+4915123456789",
  "last_validated_at": "2026-03-04"
}

Nur Handynummern, ganz bewusst

Es werden ausschließlich Handynummern zurückgegeben, keine Festnetznummern, kein VoIP. Jedes Ergebnis ist ein echtes Endgerät, und genau das macht die Ausgabe für SMS und Direktanruf nutzbar statt für eine Telefonzentrale, durch die du dich erst durchhangeln musst.

Die praktische Konsequenz: Kontakte, deren einzige Nummer eine Festnetzleitung ist, liefern einfach kein Ergebnis. Ein Treffer, der ausbleibt, ist hier weniger eine Datenlücke als ein Filter, der genau wie beabsichtigt arbeitet.

Bis zu 100 pro Call batchen

Der Endpunkt nimmt entweder eine einzelne URL oder einen Batch entgegen:

Parameter	Typ	Verwendung
linkedin_url	string	Ein Profil
linkedin_urls	array	Bis zu 100 Profile in einem einzigen Call

Batching ist hier die Praxis mit dem größten Hebel. Ein Call für 100 Profile statt 100 Calls senkt deine Anzahl an Anfragen um 99 %, und das ist wichtig, weil jede Anfrage auf dein Rate-Limit zählt, unabhängig davon, ob sie Daten zurückgibt.

{
  "linkedin_urls": [
    "https://linkedin.com/in/person-one",
    "https://linkedin.com/in/person-two"
  ]
}

Für Listen mit mehr als 100 Einträgen teile sie in Batches von 100 auf und pausiere kurz zwischen ihnen, statt alles auf einmal abzufeuern. Die Obergrenzen pro Tarif findest du unter Rate-Limits.

Zuerst Phone-Tokens budgetieren

Handynummer-Lookups ziehen aus Phone-Tokens, einem Kontingent, das dein Tarif festlegt und das von deinem regulären Token-Guthaben getrennt ist. Pro zurückgegebenem Ergebnis wird ein Phone-Token verbraucht.

Phone-Tokens pro Tarif:

Tarif	Phone-Tokens
0 €	10
27 € / Monat	10
97 € / Monat	50
997 € / Monat	250

Dir werden nur Ergebnisse berechnet, die tatsächlich zurückkommen: Profile ohne hinterlegte Handynummer kosten nichts. Ein Batch aus 100 Profilen kann daher bis zu 100 Phone-Tokens verbrauchen, mehr als die Kontingente der Tarife 0 €, 27 € und 97 € hergeben. Bemesse deine Batches also am Kontingent statt an der 100-Profile-Obergrenze des Endpunkts.

get_account und get_billing sind kostenlos und kosten niemals Tokens. Prüfe dein verbleibendes Kontingent vor einem großen Lauf, damit ein Job nicht auf halber Strecke stehen bleibt.

Qualifizieren, bevor du anreicherst

Weil Phone-Tokens auf jedem Tarif das knappste Gut sind, lohnt es sich, die Liste vor dem Aufruf dieses Endpunkts einzugrenzen statt danach. Lass zuerst deine People-Search-Filter laufen und reichere nur die Kontakte an, die du tatsächlich anrufen würdest:

• search_people mit den Filtern seniority, department und location
• Prüfe results.total und ziehe die Liste enger, bis sie die Größe hat, mit der du arbeiten willst
• Batche die resultierenden LinkedIn-URLs in linkedin_to_mobile_phone, bis zu 100 auf einmal und innerhalb deines Phone-Token-Kontingents

Eine 5.000-Zeilen-Liste „für alle Fälle” anzureichern ist der schnellste Weg, ein Phone-Token-Kontingent an einem einzigen Nachmittag aufzubrauchen.

Das Validierungsdatum lesen

last_validated_at ist das Datum, an dem die Nummer zuletzt als aktiv und in Betrieb bestätigt wurde.

Anders als bei E-Mails vergibt Hi Walter für Telefonnummern keinen Risk-Score und keine Vertrauensbewertung. Das Validierungsdatum ist das Signal: Eine Nummer, die letzte Woche bestätigt wurde, trägt mehr Vertrauen als eine, die vor einem Jahr bestätigt wurde, und es ist deine Entscheidung, wie viel Gewicht du darauf legst. Siehe Telefonnummer-Validierung verstehen.

Setze einen Schwellenwert für Veralterung, der zum Kanal passt. Eine vor 18 Monaten verifizierte Nummer kalt anzurufen verschwendet einen Anruf; eine SMS an sie zu senden verschwendet Geld und kann Beschwerden auslösen.

Verwandt

• Telefonnummer-Validierung, Was das Validierungsdatum aussagt und was nicht.
• Rate-Limits, Batching, Backoff und Obergrenzen pro Tarif.