よくある質問
性別判定 API について知っておきたいすべてのこと
すべての質問
API と連携
データと精度
アカウントと請求
セキュリティ&プライバシー
ある名前が男性・女性どちらにも使われる場合はどうなりますか?
使っている API バージョンや連携方法によって、エンドポイントのレスポンスには「accuracy」または「probability」のいずれかの値が含まれます。
accuracy パラメータは、その名前が男性か女性...
もっと読む
同じ名前でも国によって結果が変わることはありますか?
たとえば「Andrea」はイタリアでは男性名ですが、ドイツでは女性名として使われ、アメリカでは男女どちらにも使われる名前です。
このような場合、クエリ結果には 0~100 の範囲の accuracy 値(または 0...
もっと読む
データはどうやって集めているの?
可能な限り高い精度を実現するために、Gender-API.com では複数のデータソースを組み合わせています。新しい名前の主な情報源は、公開されているデータ、各国政府のデータ、そして手動での追加や修正です。
新しい名前の情報源によって...
もっと読む
名前データはどのくらいの頻度で更新していますか?
私たちは、各国の状況や公開データの入手状況に応じて、データを定期的に更新しています。
多くの欧米諸国については、年に一度のペースで更新を行っています。
また、名前の男女比は時代とともに変化することがあります。
たとえば、1...
もっと読む
AI をどう活用しているの?
人工知能(AI)は、私たちのデータベースとAPI結果の品質を日々向上させるために活用されています。AIの力によって、新しい名前データを効率的かつ正確に追加できるため、常に最新で信頼できる情報を提供できるようになっています。
さらに、A...
もっと読む
API の実装を手伝ってもらえますか?
はい、すべてのお客様にメールサポートを提供しています。contact gender-api.com までメールでお問い合わせください。できるだけ早く返信します。コード例は here にも掲載しています。
ただし、すべてのプログラミング...
もっと読む
高い精度が必要な場合はどうすればいい?
言語や名前は、時代とともに常に変化していきます。また、お客様ごとに、データセットの品質・範囲・出どころも大きく異なります。
そのため、私たちのAPIから返されるすべての結果が、常に100%正確で、あなたのデータプールと完全に一致するこ...
もっと読む
データベースにはどれくらいの名前が登録されていますか?
私たちのデータベースには、6,084,389 件の検証済みの名前が 191 か国分登録されています。世界全体では、6,196,452 種類のユニークな名前を保存しています。
平均して、結果の品質を向上させるために毎月約 10,000,00...
もっと読む
どの国がサポート対象ですか?
このAPIは 191 か国を完全にサポートしています。完全サポートとは、その国で少なくとも 件の名前データを収集していることを意味します。
ただし、ほとんどの国では、より大規模なデータセットを保有しています。どの国でどれくらいの名前をサ...
もっと読む
アラビア語の名前はサポートしていますか?
はい、当社のAPIはアラビア語の名前をサポートしています。アラビア文字での表記にも対応しています。
アラビア語は右から左へ流れるように書かれる言語で、28文字から構成されています。
たとえば「عبد ال」を問い合わせると、次の結果が得...
もっと読む
1回のリクエストで複数の名前を問い合わせできる?
もちろん可能だよ。1回のリクエストで最大100件まで名前を問い合わせできるよ。
詳しくは API Docs を確認してね。...
もっと読む
メールAPIについて聞いたことがあるよ。具体的に何ができるの?
メールAPIは、メールアドレスから名前を抽出して、そのアドレスに対応する
性別を判定できるよ。これを使えば、メール配信で相手に合った敬称をつけて
よりパーソナライズされたコミュニケーションができるようになるんだ。
たとえば「marie...
もっと読む
大量のデータがあるんだけど、CSVファイルを一括アップロードできる?
登録ユーザーなら、名(ファーストネーム)列を含む任意のCSVファイルをアップロードできるよ。
より正確に判定するために、オプションで国(カントリー)列を追加することもできる。
列名を特別に決めておく必要はなくて、どの列にどの情報(名や国...
もっと読む
CSVファイルはどのような形式にすればいいの?
Windows、MacOS、Linuxで作成されたCSVファイルに対応しているよ。
さらに、区切り文字が「;」「,」またはタブのファイルも使える。囲み文字は「"」である必要があるよ。
複数行を含むCSVファイルもアップロードでき...
もっと読む
Excelファイルをアップロードできますか?
最大300,000行までのExcelファイルをアップロードできるよ。より大きなデータセットの場合は、CSVファイルでのアップロードを利用してね。
1つのシートを含む.xlsxファイルに対応しているよ。複数シートのファイ...
もっと読む
バグを見つけたんだけど、どうすればいい?
手伝ってくれてとても助かるよ。contact gender-api.com までメールを送ってくれれば、できるだけ早く
このバグを修正するようにするね。...
もっと読む
Gender-APIは一般データ保護規則(GDPR)に準拠していますか?
Gender-API.com のすべてのサービスは、GDPRを完全に順守しているよ。
GDPR上の義務を満たすための「データ処理契約(DPA)」も用意しているよ。
...
もっと読む
プログラミング言語向けのライブラリはありますか?
当社のAPIはとてもシンプルなため、jQueryプラグイン以外のプログラミング言語向けライブラリは提供していません。ほとんどの言語では標準でJSONパーサーが利用でき、その他の言語でもすでに使える外部ライブラリが多数あります。
API...
もっと読む
リクエストはどのようにカウントされますか?
Every account will be recharged to 100 requests on the first day of every month if there are less than this number of re...
もっと読む
APIキーはどこで確認・管理できますか?
Gender-API.com のアカウントに登録すると、最初の API キーが自動的に発行されるよ。
この API キーは、アカウント概要ページの一番下に表示されている。
このキーを無効にしたいときは、「Revoke and R...
もっと読む
アカウントを複数人で共有してもいいですか?
1つのアカウントを、同じプロジェクトに関わる最大50人までの同僚やパートナーと共有できるよ。チームを管理するには、まずアカウントにログインして、アカウントメニューから「Settings」=> "Manage Your Team" をクリック...
もっと読む
2 段階認証を有効にしてアカウントを保護できますか?
2段階認証を有効にすると、アカウントをさらに安全に保護できるよ。
この追加のセキュリティ機能を有効にするには、まずアカウントにログインして、アカウントメニューから「Settings」 => "Change Password / 2FA...
もっと読む
2 段階認証を有効にしていても、サードパーティ製アプリは使える?
一部の連携機能やサードパーティ製アプリは、2段階認証を有効にしていても問題なく動作しますが、別のものは2段階認証なしでの接続が必要になる場合があります。
もしGender-API.comのログイン情報で特定のアプリにサインインできない...
もっと読む
有料アカウントと無料アカウントの違いは何ですか?
どちらのアカウントタイプでも、利用できる機能は同じだよ。すべてのAPIエンドポイントは両方のアカウントタイプで使えて、返ってくる結果もまったく同じ。
無料アカウントには、1か月あたりのリクエスト数に上限があるよ。サインアップすると、す...
もっと読む
すべてのデバイスからログアウトするにはどうすればいいですか?
アカウントでログアウトボタンをクリックした場合、ログアウトされるのは今使っているデバイスだけです。
アカウントとデータを安全に保つため、必要に応じてすべてのデバイスからログアウトすることが大切です。以下の手順に従って、当社の API ...
もっと読む
サブスクリプションと1回限りの支払いは、どう違うの?
パッケージを購入する際は、「1回限りの購入」か「サブスクリプション(定期購入)」のどちらかを選べるよ。
サービスを継続的に使う予定があるなら、サブスクリプションがおすすめ。常に十分なリクエスト数がアカウントに残っているようにできるから...
もっと読む
住民票(居住証明)が必要です。発行してもらえますか?
当社から居住証明書が必要な場合は、support までお問い合わせください。
居住証明書は、企業ごとに個別に発行依頼を行う必要があります。ご依頼の際には、御社の正式な住所、お住まいの国、可能であれば税番号を記載してくだ...
もっと読む
パッケージ / 追加リクエストはどうやって購入できますか?
サブスクリプションプランと都度払いプランのどちらかを、here から選べるよ。
一度に大きな CSV ファイルを処理したい場合や、不定期にしかリクエストを使わない場合は、都度払いプランがおすすめ。
必要なリクエスト数だけ、いつで...
もっと読む
定期購入はどうやって解約できますか?
いつでもhereからプランの変更や解約ができます。継続課金を止めたい場合は、「Cancel this subscription」ボタンをクリックしてね。...
もっと読む
一般的なAPIのレスポンス時間はどのくらいですか?
Gender-APIのAPIは高パフォーマンス向けに設計されており、通常は10〜200ミリ秒以内にレスポンスを返します。
地理的な場所やネットワーク状況、クエリの複雑さによって、レスポンス時間は多少変動することがあります。
複数...
もっと読む
レート制限やリクエスト数の制限はありますか?
すべてのユーザーに快適に使ってもらうため、公平なレート制限を設けています。
無料アカウントでは、1時間あたり最大100リクエスト、1日あたり最大500リクエストまで利用できます。
有料アカウントでは上限が大幅に緩和され、1分あた...
もっと読む
あなたたちのAPIの稼働率保証は?
すべての有料プランで、APIの稼働率99.9%を保証しているよ。私たちのインフラはエンタープライズ向けの
サーバー上で稼働していて、自動フェイルオーバーとロードバランシングに対応しているんだ。システムは24時間365日監視...
もっと読む
APIレスポンスはどんな形式?
APIレスポンスは標準でJSON形式で返されるよ。JSONは、ほぼすべてのモダンな
プログラミング言語で広くサポートされている形式だよ。各レスポンスには、リクエストされた名前、判定された性別、
精度/確率...
もっと読む
APIエラーはどう扱えばいい?
私たちのAPIは、成功か失敗かを示すために標準的なHTTPステータスコードを使っているよ。
200は成功、401はAPIキーが無効、429はレート制限超過、500はサーバーエラーを意味するんだ。
各エラー...
もっと読む
APIのバージョン管理はどうしているの?
現在、Gender-API では V1 と V2 の 2つの API バージョンを提供しているよ。V2 は最新バージョンで、確率値の返却、対応国の拡大、精度向上など、さらに強化された機能が含まれている。V1 は後方互換性のために引き続き利用...
もっと読む
名前のバリエーションやニックネームはどう扱っていますか?
私たちのデータベースには、一般的な名前のバリエーション、短縮形、ニックネームも含まれています。たとえば
「Bob」は「Robert」のバリエーションとして、「Liz」は「Elizabeth」のバリエーションとして認識されます。
...
もっと読む
API は特殊文字やアクセント付きの名前にも対応していますか?
はい!私たちのAPIは、アクセント付き文字(é、ñ、ü)、ウムラウト、ダイアクリティカルマーク、さらにアラビア語・キリル文字・中国語などの非ラテン文字も含む、Unicode文字に完全対応しているよ。
APIリクエスト内の名前は UTF...
もっと読む
どんなデータソースを使っているの?
私たちは信頼性の高い複数のデータソースを組み合わせて、できる限り正確な判定を実現しているよ。主なデータソースは次のとおり:
- 各国の政府による国勢調査データや出生記録
- 公開されている名前データベース
- ソーシャルメ...
もっと読む
プライバシーとデータ保護はどうやって守っているの?
私たちはプライバシーを何よりも重視し、GDPR、CCPA をはじめとする各種国際的なデータ保護規制に準拠しています。
サービス運用に必要なログを除き、照会された名前を保存することはありません。
すべての API 通信は HTTP...
もっと読む
支払いの請求書や領収書は発行できますか?
はい、すべての購入に対して請求書が自動で発行され、account dashboard から確認できます。PDF 請求書はいつでもダウンロードでき、登録済みのメールアドレスにも送信されます。
請求書には、必要に応じて VAT 情報を含む...
もっと読む
返金ポリシーはどうなっていますか?
初回購入には、シンプルな14日間の返金保証があります。
サービスに満足できない場合、最初の14日以内であれば理由を問わず全額返金します。
サブスクリプション料金については、いつでも解約でき、今後の...
もっと読む
どんなサードパーティ連携が利用できますか?
当社は、Zapier、Make(旧Integromat)、Googleスプレッドシート、Microsoft Excel、Salesforce、HubSpot、
多くのCRMシステムなど、人気のプラットフォームやツールとの連...
もっと読む