Zum Inhalt springen
POST AI agent ready /v1/nationality/estimate

Nationalitätsvorhersage-API – Schätzen Sie das Herkunftsland anhand des Namens

Schätzt die wahrscheinlichsten Herkunftsländer für einen bestimmten Namen mithilfe statistischer Modelle, die auf globalen demografischen Daten trainiert wurden. Gibt eine Reihe von Ländern zurück, sortiert nach Wahrscheinlichkeit mit ISO 3166-1 Alpha-2-Codes. Nützlich für Lokalisierung, demografische Analyse und Internationalisierung.

Parameters

stringrequired

Name (first or last) to predict nationality for.

Code examples

curl -X POST https://api.botoi.com/v1/nationality/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Tanaka"}'

When to use this API

Automatische Auswahl von Gebietsschema und Sprache

Wenn sich ein neuer Benutzer nur mit seinem Namen anmeldet, sagen Sie sein wahrscheinliches Herkunftsland voraus und stellen Sie die Sprache der Benutzeroberfläche und die Gebietsschemaeinstellungen entsprechend ein. Ein Benutzer namens „Tanaka“ würde Japanisch als vorgeschlagene Sprache sehen, was ihm einen manuellen Auswahlschritt erspart.

Marktforschung und Zielgruppenanalyse

Analysieren Sie die Nationalitätsverteilung Ihrer Benutzerbasis oder E-Mail-Liste, indem Sie Namen stapelweise über diesen Endpunkt laufen lassen. Identifizieren Sie, in welchen Ländern Ihr Produkt am meisten Anklang findet, und weisen Sie Marketingbudgets den Regionen mit den höchsten Chancen zu.

KYC- und Identitätsüberprüfung vorab

Vergleichen Sie beim KYC-Onboarding die vorhergesagte Nationalität mit dem angegebenen Wohnsitzland oder Passland. Eine große Abweichung stellt an sich noch keinen Betrug dar, kann jedoch zusätzliche Überprüfungsschritte in Ihrem Risikomodell auslösen.

Frequently asked questions

Kann ich Vornamen, Nachnamen oder vollständige Namen verwenden?
Der Endpunkt funktioniert mit jeder Namenseingabe. Nachnamen (Nachnamen) erzeugen oft deutlichere Nationalitätssignale als Vornamen. Sie können den Vornamen, den Nachnamen oder den vollständigen Namen übergeben, wobei Einzel-Token-Eingaben (jeweils ein Name) in der Regel am genauesten sind.
Was bedeutet der Wahrscheinlichkeitswert?
Für jedes Land in der Antwort liegt die Wahrscheinlichkeit zwischen 0 und 1, was die Wahrscheinlichkeit darstellt, dass eine Person mit diesem Namen aus diesem Land stammt. Eine Wahrscheinlichkeit von 0,85 für JP bedeutet, dass 85 % der Personen mit diesem Namen im Datensatz aus Japan stammen.
Wie viele Länder werden zurückgegeben?
Die Antwort umfasst bis zu 5 nach Wahrscheinlichkeit geordnete Länder. Es werden nur Länder mit einer nicht vernachlässigbaren Wahrscheinlichkeit (über ~0,01) berücksichtigt. Namen, die stark mit einem Land verbunden sind, liefern möglicherweise weniger Ergebnisse.
Warum zeigt „Tanaka“ Brasilien als Nebenspiel?
Brasilien hat die größte japanische Diaspora außerhalb Japans. Namen wie „Tanaka“ tauchen aufgrund der japanischen Einwanderung im frühen 20. Jahrhundert in brasilianischen Aufzeichnungen auf. Das Modell spiegelt die reale Namensverteilung in den einzelnen Ländern wider.
Wird der Name vor der Verarbeitung normalisiert?
Ja. Namen werden in Kleinbuchstaben geschrieben und von Leerzeichen befreit. Diakritische Zeichen bleiben erhalten und tragen zur Vorhersage bei, da akzentuierte Zeichen Nationalitätssignale enthalten (z. B. „Muller“ vs. „Mueller“).

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs