POST AI agent ready /v1/nationality/estimate

国籍预测 API - 根据姓名估计原籍国

使用根据全球人口数据训练的统计模型来估计给定名称的最可能的原籍国。返回使用 ISO 3166-1 alpha-2 代码按概率排名的国家/地区数组。对于本地化、人口统计分析和国际化很有用。

Endpoint

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

When to use this API

当新用户仅使用其姓名注册时，请预测他们可能的原籍国并相应地默认界面语言和区域设置。名为“Tanaka”的用户会将日语视为建议语言，从而节省了手动选择步骤。

通过此端点批量运行名称来分析用户群或电子邮件列表的国籍分布。确定您的产品最能引起哪些国家的共鸣，并将营销预算分配给机会最大的地区。

在 KYC 入职期间，将预测的国籍与声明的居住国或护照国家进行比较。较大的不匹配本身并不是欺诈，但它可能会在风险模型中触发额外的验证步骤。

我可以使用名字、姓氏或全名吗？

端点适用于任何名称输入。姓氏通常比名字更能产生独特的国籍信号。您可以传递名字、姓氏或全名，但单标记输入（一次一个名称）往往是最准确的。

概率分数是什么意思？

响应中的每个国家/地区的概率介于 0 和 1 之间，表示具有该名称的人来自该国家/地区的可能性。 JP 的概率为 0.85，意味着数据集中有该名字的人中有 85% 来自日本。

返回了多少个国家？

响应最多包括按概率排名的 5 个国家/地区。仅包括具有不可忽略概率（高于 ~0.01）的国家。与一个国家/地区密切相关的名称可能会返回较少的结果。

为什么“田中”将巴西作为次要比赛？

巴西拥有日本以外最大的日本侨民。由于 20 世纪初日本移民，“Tanaka”等名字出现在巴西记录中。该模型反映了现实世界中各个国家的名称分布。

处理前名称是否已标准化？

是的。名称采用小写形式并去掉空格。变音符号被保留并有助于预测，因为重音字符带有国籍信号（例如“Muller”与“Mueller”）。

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