根据姓名识别性别
根据名字或全名估算性别
获得附带置信度和预测来源的估算结果。无法做出预测时，V2 会明确将其标记为未知结果。
- 名字和全名
- 已知国家/地区时可提供地区背景
- 拉丁及非拉丁文字姓名
GenderAPI.io · REST API v2
适用于姓名、电子邮箱和用户名的 Gender API
根据名字、全名、电子邮箱地址或用户名估算可能的性别。GenderAPI.io V2 返回结构化 JSON，包含预测来源、置信度以及可选的国家/地区背景。
GenderAPI.io V2
试用 V2 姓名请求
GET
https://api.genderapi.io/api/v2/gender?type=name&value=Hao2026年10月1日获取的真实 V2 响应。发送请求即可查看实时结果。
| 姓名 | Hao |
|---|---|
| 性别 | 男性 |
| 置信度 | 91.1% |
| 国家/地区 | 美国 (US) |
| 来源 | 姓名数据集 |
| 已用积分 | 1 |
{
"data": {
"input": {
"type": "name",
"value": "Hao",
"country": null
},
"name": "hao",
"gender": "male",
"country": "US",
"confidence": 0.9107981220657277,
"confidence_kind": "observed_frequency",
"sample_count": 852,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "hao",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "67c19ed6-db8d-4a8c-a045-234a7e0adbbe",
"duration_ms": 26,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 1,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}分析名字和全名
面向全球姓名的 Gender API
您可以逐条查询、发送批量请求，或使用我们的表格工具。V2 会明确区分有预测和无预测的结果，让您的应用保留不确定性，而不是强行给出猜测。
- 覆盖范围因姓名和国家/地区而异
- 全球
- 置信度，并注明来源和含义
- 0–1
- JSON 中包含结果和已用积分
- V2
- 使用 API 密钥时每个批量请求的条目数；IP 试用为 10 个
- 50
根据电子邮箱识别性别
利用电子邮箱地址中的姓名信号
解读常见邮箱格式中的姓名信号，为 CRM、潜在客户和分析数据补充性别估算及其来源。
- 个人和企业邮箱地址
- 补充 CRM 记录
- 响应中包含置信度和来源
根据用户名识别性别
分析用户名和昵称
识别用户名中包含的常见名字。使用 forceToGenderize 时，即使昵称中没有真实名字，也可以请求估算，但不保证一定得到预测。
- 社交媒体和社区的用户数据
- 可选的昵称分析
- 没有预测时状态清晰明确
Excel 和 CSV 处理
批量处理姓名列表
上传 Excel 或 CSV 文件，选择来源列并下载结果。如需从您的应用发送批量请求，请参阅 V2 批量请求指南。
- Excel 和 CSV 文件
- 包含名字、全名或电子邮箱地址的列
- 可选的国家/地区背景
GenderAPI.io 集成
集成 API，或连接您已在使用的工具
从 REST API 开始，或将 GenderAPI.io 连接到电子表格、电商平台和自动化服务。请在每份指南中确认该集成使用的 API 版本。
REST APIGoogle SheetsExcel 和 CSVShopifyAirtableZapierMakeIntegrately
查看全部集成GenderAPI.io 是什么？
GenderAPI.io 根据姓名、电子邮箱地址或用户名估算可能的性别。V2 在 JSON 中返回预测、置信度、来源和已用积分。这些估算基于姓名中的常见规律，并不能确认一个人自述的性别认同。
V2 什么时候使用 AI？
单条请求会先查询数据集。如果数据集中没有预测，默认会使用 AI。这一默认模式总共消耗 1 个积分，包括 AI 的使用。批量请求默认不使用 AI。您可以选择 AI 模式，或启用 forceToGenderize 来分析昵称。
如何解读置信度和未知结果？
在 V2 中，confidence 字段的值为 0 到 1 之间的数值或 null。confidence_kind 字段用于区分数据集中观察到的频率和模型给出的数值；置信度并不能保证结果正确。没有预测时，响应包含 gender: null 和 result_status: unknown。
一条请求消耗多少积分？
标准 V2 请求消耗 1 个积分，即使使用了 AI，或成功处理的结果中没有预测也是如此。AI 模式 always 消耗 2 个积分。使用 forceToGenderize 时，来自数据集的预测消耗 1 个积分；如果需要使用 AI，总共消耗 2 个积分。批量请求按条目计费。
可以在一条请求中发送多个条目吗？
可以。使用有效的 API 密钥时，V2 每个批量请求最多接受 50 个条目；使用 IP 试用时最多 10 个。因此，一条 HTTP 请求可能消耗多个积分。较大的文件也可以使用 Excel 和 CSV 工具或其他集成进行处理。
可以免费试用 API 吗？
没有 API 密钥时，V2 演示使用 IP 试用，每 24 小时提供 10 个积分，由使用同一 IP 地址的所有用户共享。免费账户每天可获得 200 个积分。这些是积分额度，而不是固定的请求次数：消耗 2 个积分的模式会更快用完余额。
我现有的 API 密钥可以用于 V2 吗？
可以。V1 和 V2 使用同一个 API 密钥和同一个账户余额。现有的 V1 集成仍然可用。新的集成应以 V2 文档为准，因为 V2 的接口、响应字段和错误格式都与 V1 不同。
开始开发
免费试用 GenderAPI.io
创建账户，用每天 200 个免费积分测试您的第一批请求，并在需要时处理 Excel 或 CSV 文件。