最大50件のユーザー名から性別を推定

大量リクエストの概要

最大50のユーザー名を処理

送信するdata配列。GenderAPIは各ハンドルから潜在的な名前信号を抽出し、オプションの記録とともに結果を返しますid.

MethodPOST

Maximum50のユーザー名

AuthenticationBearerトークン

AIオプションサポートされていません

大量のユーザー名結果は慎重に確認する必要があります。

ハンドルにはブランド、ファンタジー用語、または関係のない単語が含まれる可能性があります。大量のリクエストは受け付けていませんaskToAI or forceToGenderize. 不審な入力に対して高い信頼性で処理するには、1つのリクエスト.

HDR

必須のHTTPヘッダー

ブロックスリクエストを認可する

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSONリクエストボディ

パラメータ

Field	Type	Requirement	Description
`data`	object[]	必須	1から50までのユーザー名レコードを含む配列
`data[].username`	string	必須	分析するユーザー名またはハンドル；アンダースコアと数字はサポートされています
`data[].country`	string	オプション	地域コンテキストとして使用されるISO 3166-1 alpha-2国コード
`data[].id`	string \| integer	オプション	あなたの識別子。対応する結果と共にそのまま返されます

入力ガイド

ラテン文字によるユーザー名は一般的に名前を明確に伝えるのに適している。ユニークな値を使用し、抽出された値を評価した上で記録を更新する。id値name and probabilityを評価した上で記録を更新する。

リクエストペイロード

ユーザー名配列を構築する

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

コード例

複数ユーザー名のリクエストを送信する

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200レスポンス

抽出された名前と予測結果

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

レスポンスフィールド

Field	Type	Description
`status`	boolean	ブロックリクエストが成功したかどうかを示します。
`used_credits`	integer	提出されたユーザー名ごとの消費されたクレジット数。
`remaining_credits`	integer	リクエスト後の残りクレジット数。
`expires`	integer	パッケージの有効期限がUNIXタイムスタンプで表される値。
`names`	object[]	提出されたユーザー名に対する結果。
`names[].name`	string	ユーザー名から抽出された可能性のある名前。
`names[].q`	string	リクエストに提出された元のユーザー名。
`names[].gender`	string \| null	予測値：男性、女性、またはnull。
`names[].country`	string	この結果に該当する国コード
`names[].total_names`	integer	この結果を支持するサンプル数
`names[].probability`	integer	予測信頼度（パーセンテージ）
`names[].id`	string \| integer	記録の相関のために返された入力識別子
`duration`	string	サーバー処理時間の合計

各リクエストは50件までに抑える

大きな入力はバッチに分割する。ユーザー名は間接的なシグナルであるため、抽出された名前を確認し、適切な確率閾値を設定した上で結果を適用する。

次回参照

電話番号の検証とフォーマット

電話番号の検証検証およびフォーマット方法を確認 →Username 1つのリクエストUse AIオプション for one handle →