名前から国籍を推定する：名前がわかること、わからないこと

返ってくる内容

POST 1 回、名前 1 件、レスポンス 1 件。下のリストは短縮しています。実際のものは上位 25 か国まで続きます

POST https://gender-api.com/v2/country-of-origin
{ "first_name": "Johann" }

{
    "result_found": true,
    "first_name": "Johann",
    "gender": "male",
    "probability": 0.9,
    "language_of_origin": "Germanic",
    "meaning": "…",
    "country_of_origin": [
        {
            "country_name": "Germany",
            "country": "DE",
            "probability": 0.52,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        },
        {
            "country_name": "Austria",
            "country": "AT",
            "probability": 0.48,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        }
    ],
    "ethnicity": {
        "id": "GERMANIC",
        "name": "Germanic (German, Austrian, Swiss)",
        "distribution": [ … ]
    },
    "details": { "credits_used": 2, "samples": 890, "duration": "414ms" }
}

答えを検証可能にする 2 つのフィールドに注目してください。samples は答えが何件のレコードに基づいているかを示し、credits_used は 2 credits を確認します。サンプル数の少ない答えを隠すことはありません

• continental_region と statistical_region を使えば、独自のマッピングを保守せずにリストを地域単位にまとめられます
• レスポンスにはその名前のインタラクティブな地図へのリンクも含まれます。結果を目で確かめるのに一番速い方法です
• 各フィールドは v2 リファレンス に記載されています

これが何でないか

名前は名前についての手がかりです。それを人についての手がかりとして扱うところで、この種のデータは道を外れます。だからこそ、その上に何かを作る前に限界をはっきり述べておく価値があります

• これは国籍でも市民権でも出生地でもなく、そのいずれの証拠でもありません
• これはその人の民族的属性ではありません。民族分布は名前がグループ間にどう広がっているかを表すもので、名前の性質です
• 個々の人について何かを決めるべきものではありません——価格も、申込みの可否も、リスクスコアも。民族的出身を示すデータは GDPR 第 9 条の特別なカテゴリーにあたり、その判断は管理者としてのお客様のものであり、当社のものではありません
• 推測ではありません。保有が少なすぎる場合は result_found が false になり、サンプル数がそれを示します。フィールドを埋めるためにもっともらしい国を作り出すことはしません

当社側では、ドイツの会社であり、サーバーはすべてドイツにあり、データは EU 内で処理され、データ処理契約はアカウントから請求できます。全体像は プライバシー概要 にあります

リスト全体に対して実行する

バッチ形式はリクエストあたり最大 100 件の名前を受け取り、リクエスト数に上限はありません。ペイロードは素の JSON 配列です

POST https://gender-api.com/v2/country-of-origin
[
    { "first_name": "Johann" },
    { "full_name": "Andrea Rossi" }
]

• 名の代わりにフルネームやメールアドレスでも動きます——まず名前を抽出し、それから出身を解決します
• PHP、Python、Node、Java、Go、Ruby、Rust、Perl、.NET 向けの公式クライアント
• 組み込みではなく一度だけのリストなら 一括性別判定 をご覧ください——同じ credits で、コードは不要です
• すべてのフィールド、すべてのエラー、OpenAPI の記述：v2 リファレンス