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 オンボーディング中に、予測された国籍を宣言された居住国またはパスポートの国と比較します。大きな不一致自体は不正ではありませんが、リスクモデルで追加の検証手順がトリガーされる可能性があります。

名、姓、またはフルネームを使用できますか?

エンドポイントは、任意の名前入力で機能します。姓（姓）は、多くの場合、名よりも特徴的な国籍シグナルを生成します。名、姓、またはフルネームを渡すことができますが、単一トークンの入力 (一度に 1 つの名前ずつ) が最も正確である傾向があります。

確率スコアは何を意味しますか?

応答内の各国には、その名前を持つ人がその国の出身である可能性を表す 0 から 1 までの確率があります。 JP の確率 0.85 は、データセット内のその名前を持つ人の 85% が日本出身であることを意味します。

返還された国は何カ国ありますか?

応答には、確率に従ってランク付けされた最大 5 か国が含まれます。無視できない確率 (~0.01 以上) を持つ国のみが含まれます。 1 つの国と強く関連付けられた名前では、返される結果が少なくなる場合があります。

なぜ「田中」は二次戦としてブラジルを見せるのか？

ブラジルは日本国外に離散した日系人が最も多い国である。 20世紀初頭の日本人移民により、ブラジルの記録に「タナカ」のような名前が登場する。このモデルは、各国にわたる実際の名前の分布を反映しています。

名前は処理前に正規化されていますか?

はい。名前は小文字にされ、空白が削除されます。アクセント付き文字は国籍シグナルを伝えるため (例: 「ミュラー」対「ミューラー」)、発音区別符号は保存され、予測に貢献します。

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