# GenderAPI.io V2ドキュメント

> 最初のリクエストを送信し、アプリケーションを接続して、結果の読み方を理解しましょう。名前、メールアドレス、ユーザー名のいずれかから始められます。

Canonical HTML: https://www.genderapi.io/ja/api-documentation

Last reviewed: 2026-09-29

## 最初のリクエストを送信する

名前、メールアドレス、ユーザー名を送信すると、性別の推定結果をJSONで受け取れます。まずAPIキーなしでブラウザから下のURLを開き、その後アプリケーションを接続するためのガイドを選んでください。

IPトライアルでは、IPアドレスごとに24時間あたり10クレジットが付与され、V1と共有されます。このデータセットのみの例は、ページの再読み込みを含め、リクエストごとに1クレジットを消費します。既存のAPIキーを接続すると、V1とV2は同じアカウント残高を使用します。

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Sakura&country=JP&ai_mode=off
```

- [GETの例を開く（IPトライアルの1クレジットを消費）](https://api.genderapi.io/api/v2/gender?type=name&value=Sakura&country=JP&ai_mode=off)
- [APIキーを設定する](https://www.genderapi.io/ja/docs/v2/authentication#environment-setup)
- [JSONレスポンスを理解する](https://www.genderapi.io/ja/docs/v2/responses)

## 何をしたいですか？

入力の種類を選ぶと、cURL、JavaScript、Python、PHP、Java、C#、Goでそのまま実行できる例を確認できます。実際のレスポンスを処理する準備ができたら、結果とクレジットのガイドをご覧ください。

- [APIキーとIPトライアル](https://www.genderapi.io/ja/docs/v2/authentication): APIキーを接続するか、APIを無料で試せます。
- [リクエストパラメーター](https://www.genderapi.io/ja/docs/v2/request-parameters): 入力フィールド、国のコンテキスト、リクエストオプションを選びます。
- [公式SDK](https://www.genderapi.io/ja/docs/v2/sdks): 使用するプログラミング言語に対応した公式クライアントをインストールします。
- [名前から性別を推定](https://www.genderapi.io/ja/docs/v2/gender-from-name): 名またはフルネームを調べます。
- [メールアドレスから性別を推定](https://www.genderapi.io/ja/docs/v2/gender-from-email): メールアドレスに含まれる名前の手掛かりを探します。
- [ユーザー名から性別を推定](https://www.genderapi.io/ja/docs/v2/gender-from-username): ユーザー名またはニックネームを入力として使用します。
- [バッチリクエスト（batch）](https://www.genderapi.io/ja/docs/v2/batch): 最大50件の名前、メールアドレス、ユーザー名を一度に処理します。
- [電話番号の検証](https://www.genderapi.io/ja/docs/v2/phone-validation): 電話番号を検証し、形式を整えます。
- [レスポンスを読む](https://www.genderapi.io/ja/docs/v2/responses): 推定結果、信頼度、不明な結果を読み取ります。
- [AIとニックネーム](https://www.genderapi.io/ja/docs/v2/ai-options): AIを使うタイミングとニックネームの扱い方を選びます。
- [クレジットと残高](https://www.genderapi.io/ja/docs/v2/credits-and-usage): 残高と、各リクエストで消費するクレジットを確認します。
- [エラーと再試行](https://www.genderapi.io/ja/docs/v2/errors-and-retries): エラーを解決し、再試行すべきかどうかを判断します。
- [V1からの移行](https://www.genderapi.io/ja/docs/v2/migration): 同じAPIキーのまま既存の連携を更新します。

## エンドポイント一覧

https://api.genderapi.io と、この表の絶対パスを組み合わせて使用します。例：https://api.genderapi.io/api/v2/gender。クエリパラメーターを使えるのはGET /genderだけです。POSTのルートではJSONボディを使用し、V2のリクエストにname、email、username、askToAIなどのV1フィールドを送信しないでください。

| メソッド | パス | 用途 |
| --- | --- | --- |
| GET | /api/v2 | 公開されている機能と現在の上限。無料です。 |
| GET | /api/v2/openapi.json | 正式なOpenAPI仕様。無料です。 |
| GET | /api/v2/errors | 機械可読なエラーカタログ。無料です。 |
| GET | /api/v2/usage | 現在のアカウント残高またはIPトライアルの残高。無料です。 |
| GET / POST | /api/v2/gender | 1件の名前、メールアドレス、またはユーザー名。 |
| POST | /api/v2/gender/batch | 名前、メールアドレス、ユーザー名を順序どおりにまとめたバッチ。 |
| POST | /api/v2/phone/validate | 電話番号を検証し、形式を整えます。 |