性別の一括判定：1万件から 10,000,000 件まで
ファイルをアップロードするか、API を呼び出す。どちらでも、始める前に価格が分かり、各行は根拠付きで戻り、あなたの表はあなたの表のまま戻ってきます
結論
- CSV 1つで最大 10,000,000 行、Excel ブック1つで 100,000 行、または API 1リクエストあたり 100 件（リクエスト数に上限なし）
- 参照1回が1 credit で、前払いです。1,000件あたり €0.35 から。作業全体の価格は開始前に分かり、VAT 付きの請求書が出て、credit に有効期限はありません
- ブックは差し替えではなく返却されます。書式、日付、数式、結合セル、他のシートはすべて残ります。新しい列はあなたのデータの横に差し込まれます
- 各行が確率とサンプル数を持つので、確度の高い行は自動で採用し、残りだけを確認に回せます
2つのやり方と、その選び方
一度きりの整理と、継続的に付加処理されるデータベースは別の仕事です。同じデータが両方に答えますが、両方に同じ経路を使うべきではありません
| 項目 | ファイルをアップロード | API を呼ぶ |
|---|---|---|
| 向いている場面 | いま手元にあるリスト。CRM のエクスポート、イベントの申込リスト、メール配信リストなど | 継続的に入ってくる名前。登録、注文、取り込んだリードなど |
| 誰がやるか | ファイルを持っている人なら誰でも。コード不要 | 最初に開発者が一度。あとは自動で回ります |
| サイズの上限 | CSV あたり 10,000,000 行、Excel ブックあたり 100,000 行 | 1リクエストあたり 100 件、総数の上限なし |
| 返ってくるもの | 新しい列が差し込まれた同じファイル | 名前ごとの JSON。好きな場所に書き込めます |
| 国の指定 | アシスタントで国の列を割り当てる | 名前ごとに国・locale・IP アドレス |
| 処理中 | 処理はバックグラウンドで続きます。終わるとダウンロードリンク付きのメールが届きます | 同期的。1リクエストに1つの答え |
| 費用 | 同じです。どちらでも参照1回につき1 credit、同じ残高から | |
大量処理の実際の費用
課金は参照単位で、ユーザー単位でも月額でもありません。解決した名前1件が1 credit で、ファイル経由でも API 経由でも同じです。量が増えるほど単価は下がります
| 名前 | それを満たす最も安い公開パッケージ（税抜） |
|---|---|
| 10,000 | €16.99 |
| 100,000 | €99.00 |
| 500,000 | €299 |
| 10,000,000 | お見積もりをご依頼ください |
購入前にやっておく価値のあることが2つあります。どちらも支払額を下げます。1つはリストの重複を削ること（同じ名前が2回あれば2 credit かかります）、もう1つは実際には性別が不要な行を落とすことです。送らなかった名前は無料であり、実際の顧客エクスポートでは、この2手順でファイルの意外に大きな部分が減ります
最新の金額、すべての段階、サブスクリプションの選択肢は料金ページにあります。最大の公開パッケージより大きい場合は、ご相談ください。特別な案件ではなく、ごく普通の話です
あなたの表は、表のまま戻ってきます
ここは普通、雑に扱われる部分なので、はっきり書きます。あなたのデータを抜き出して性別を付け、新しいファイルを渡すのではありません。あなたのブックを開き、その中に新しい列を書き込んで、返します
- 書式、数値・日付の表示形式、数式、結合セルは保持されます。日付は日付のまま、数式は数式のままです
- 複数シートのブックは複数シートのまま残ります。アップロードはすべてのシートを調べ、データのある最初のシートを選び、シート選択で別のシートに切り替えられます
- 見出し行が1行目である必要はありません。自動で検出され、検出が違っていればプレビューで正しい行をクリックします
- 表の上にある自由記述、C 列から始まる表、欠けている・重複している列見出し。すべて対応しています。実際のエクスポートはそういう見た目だからです
データの横に追加される列：
| 列 | 内容 |
|---|---|
ga_gender |
判定結果。ラベルは自由に選べます。male/female/unknown、m/f、1/2、あるいは既存の CRM が期待している表記でも構いません |
ga_accuracy |
その名前について観測された分布がどれだけ一方に偏っているかを、0 から 100 の整数で示します。（API は同じものを 0 から 1 の確率として返します。）任意の列です |
ga_samples |
その根拠となる観測件数。任意の列で、結果を検証可能にするのはこの列です |
ga_first_name |
実際に解決した名前。入力がフルネームやメールアドレスだった場合に役立ちます。任意の列です |
アップロードアシスタントの手順。ファイルで試す
大規模になるほどサンプル数が重要になる理由
10件なら結果を目で確かめられます。100万件では無理です。ですから問いは、どの行を未確認のまま使うかに変わります
各行が確率と、その根拠となる観測件数を持っているので、その線は自分で引けます。よくあるのは、十分なサンプル数があり ga_accuracy 90 以上のものは採用し、残りは人の確認か中立的な呼びかけに回す、という引き方です。もう一方の選択肢、つまりデータベース全体に対して誰かが決めた1つの確信度を当てる方法は、大規模に誤った呼びかけをしてしまう原因になります
データベースが解決できない名前は、推測で埋めるのではなく性別の列を空のままにします。9,124,598 か国にわたる 192 件の名前があるため、通常のリストではごく一部ですが、それを目で確認できます
リストが複数の国にまたがる場合は、それを指定してください。同じ名前がどこでも同じ性別とは限りません。この点は別途まとめました
コードで書く場合
継続的な付加処理には、一括エンドポイントが1リクエストあたり最大 100 件を受け付けます：
POST https://gender-api.com/v2/gender/by-first-name-multiple
[
{ "first_name": "Sandra", "country": "DE" },
{ "first_name": "Andrea", "country": "IT" }
]各項目は独立して判定され、それぞれの確率・サンプル数・国を持ちます。つまり一括処理は本当に一括処理であり、1つの答えを複数の名前に当てているのではありません
- PHP、Python、Node、Java、Go、Ruby、Rust、Perl、.NET 向けの公式クライアント
- v2 の完全なリファレンス、OpenAPI 記述、Postman コレクション
- 作業をコーディングアシスタントに任せたい場合は、/skill.md にそのまま渡せる実装ガイドがあります
- 表計算ソフトや CRM で作業したい場合は、Excel、Google Sheets、Shopify、HubSpot、Salesforce、Zapier などの既製の連携があります
調達部門からの質問
実在する顧客の名前のリストは個人データです。大量の処理は通常、まさにこの点を尋ねる人の承認が必要になります
- 当社はドイツの企業です。すべてのサーバーはドイツにあり、データは EU 内で処理されます
- アップロードされたファイルは暗号化して保存され、10日後に削除されます。自分で削除すればそれより早く消えます
- データ処理契約はアカウントから請求できます
- サーバーログには送信された名前が含まれ、会計上の理由で14日間保管されます
- すべての購入で正式な VAT 付き請求書が発行され、EU の VAT 番号も正しく処理されます
- 買い切りパッケージの credit に有効期限はないので、大きな整理を一度だけ行うのにサブスクリプションは要りません
全体像はプライバシーの概要にあります
よくある質問
一度にどれくらいの名前を処理できますか
CSV ファイル1つで最大 10,000,000 行、Excel ブック1つで最大 100,000 行、API では1リクエストあたり 100 件です。リクエスト数に上限はありません。それより多い場合はファイルを分割するか、API をループで呼び出してください
大量の性別判定はいくらかかるのか
1回の参照が1 credit なので、価格は始める前に決まります。50万件をカバーする最も安い公開パッケージは €299（税抜）です。最大の公開パッケージを超える場合は、定価ではなく個別のお見積もりになります。credit は前払いで購入し、有効期限はなく、購入ごとに VAT 付きの請求書が出ます
開発者が必要ですか
いりません。ファイルをアップロードし、名前が入っている列を指定して、完成したファイルをダウンロードするだけです。コードは1行も書きません。API は、付加処理が一度きりではなく継続的に必要な場合のためにあります
Excel ファイルはそのまま戻ってきますか
はい。書式、数値・日付の表示形式、数式、結合セル、そして他のすべてのシートは元のまま残ります。あなたのデータから新しいファイルを生成するのではなく、新しい列をあなたのブックに書き込みます
データベースが解決できない行はどうなりますか
性別の列は空のままで、サンプル数がその理由を示します。空欄を埋めるための推測は一切しません。ですからその行を絞り込んで自分で判断できます。後から推測に気づく、ということが起きません
一括アップロードは GDPR に準拠していますか
当社はドイツの企業で、すべてのサーバーはドイツにあり、データは EU 内で処理されます。アップロードされたファイルは暗号化して保存され、10日後に削除されます。データ処理契約はアカウントから請求できます
支払う前に試せますか
はい。すべてのアカウントに毎月 100 回の無料参照が含まれます。ファイル全体分の credit を買う前に、自分のリストのサンプルを流して結果を確認するには十分です
自分のリストのサンプルから始める
毎月 100 回の無料参照、クレジットカード不要。実ファイルの一部を流して結果を確認し、それから全体分を購入できます
