POST AI agent ready /v1/nationality/estimate

API de prédiction de nationalité - Estimer le pays d'origine à partir du nom

Estimation des pays d'origine les plus probables pour un nom donné à l'aide de modèles statistiques formés sur des données démographiques mondiales. Renvoie un tableau de pays classés par probabilité avec les codes ISO 3166-1 alpha-2. Utile pour la localisation, l’analyse démographique et l’internationalisation.

Endpoint

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

Sélection automatique des paramètres régionaux et de la langue

Lorsqu'un nouvel utilisateur s'inscrit avec uniquement son nom, prédisez son pays d'origine probable et définissez par défaut la langue de l'interface et les paramètres régionaux en conséquence. Un utilisateur nommé « Tanaka » verrait le japonais comme langue suggérée, ce qui lui éviterait une étape de sélection manuelle.

Etude de marché et analyse d'audience

Analysez la répartition par nationalité de votre base d'utilisateurs ou de votre liste de diffusion en exécutant les noms via ce point de terminaison par lots. Identifiez les pays dans lesquels votre produit résonne le plus et allouez des budgets marketing aux régions les plus opportunités.

Pré-sélection KYC et vérification d’identité

Lors de l'intégration KYC, comparez la nationalité prévue avec le pays de résidence déclaré ou le pays du passeport. Une disparité importante ne constitue pas une fraude en soi, mais elle peut déclencher des étapes de vérification supplémentaires dans votre modèle de risque.

Frequently asked questions

Puis-je utiliser des prénoms, des noms de famille ou des noms complets ?

Le point de terminaison fonctionne avec n’importe quelle entrée de nom. Les noms de famille (noms de famille) produisent souvent des signaux de nationalité plus distinctifs que les prénoms. Vous pouvez transmettre le prénom, le nom ou le nom complet, bien que les entrées à jeton unique (un nom à la fois) aient tendance à être plus précises.

Que signifie le score de probabilité ?

Chaque pays dans la réponse a une probabilité comprise entre 0 et 1 représentant la probabilité qu'une personne portant ce nom soit originaire de ce pays. Une probabilité de 0,85 pour JP signifie que 85 % des personnes portant ce nom dans l'ensemble de données sont originaires du Japon.

Combien de pays sont retournés ?

La réponse comprend jusqu'à 5 pays classés par probabilité. Seuls les pays avec une probabilité non négligeable (supérieure à ~0,01) sont inclus. Les noms fortement associés à un pays peuvent renvoyer moins de résultats.

Pourquoi "Tanaka" montre-t-il le Brésil comme match secondaire ?

Le Brésil possède la plus grande diaspora japonaise en dehors du Japon. Des noms comme « Tanaka » apparaissent dans les archives brésiliennes en raison de l'immigration japonaise au début du 20e siècle. Le modèle reflète la répartition réelle des noms entre les pays.

Le nom est-il normalisé avant le traitement ?

Oui. Les noms sont en minuscules et dépourvus d’espaces. Les signes diacritiques sont conservés et contribuent à la prédiction, puisque les caractères accentués portent des signaux de nationalité (par exemple, « Muller » contre « Mueller »).

Get your API key

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