API xác định giới tính từ email

Tổng quan yêu cầu

Từ địa chỉ email đến kết quả dự đoán

GenderAPI phân tích phần đứng trước ký tự @, trích xuất tên riêng có khả năng nhất rồi dùng tên đó để dự đoán giới tính. Hãy cung cấp quốc gia khi biết khu vực của người dùng.

01Email đầu vàolinh.nguyen@example.com

02Trích xuất tênLinh

03Dự đoánfemale · 97%

Phương thứcPOST

Loại nội dungapplication/json

Xác thựcBearer token

Chi phí credit1 lượt tra cứu

HDR

HTTP header bắt buộc

Xác thực yêu cầu

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Phần thân yêu cầu JSON

Tham số

Tham số	Kiểu	Yêu cầu	Mô tả
`email`	string	Bắt buộc	Địa chỉ email cần phân tích. GenderAPI trích xuất tên riêng có khả năng nhất trước khi dự đoán.
`country`	string	Không bắt buộc	Mã quốc gia ISO 3166-1 alpha-2, chẳng hạn VN hoặc US, để bổ sung ngữ cảnh khu vực.
`askToAI`	boolean	Không bắt buộc	Khi là true, dùng AI dự phòng nếu tên được trích xuất không có kết quả trong cơ sở dữ liệu.

AI dự phòng

askToAI được đánh giá sau bước trích xuất tên và chỉ chạy khi tên đó không có trong cơ sở dữ liệu. Endpoint email không chấp nhận forceToGenderize.

Ví dụ mã

Gửi một yêu cầu email

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"linh.nguyen@example.com","country":"VN","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "linh.nguyen@example.com", country: "VN", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "linh.nguyen@example.com", "country": "VN", "askToAI": True}
)
print(response.json())

Phản hồi 200

Tên được trích xuất và kết quả dự đoán

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "linh.nguyen@example.com",
  "name": "Linh",
  "gender": "female",
  "country": "VN",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

Các trường phản hồi

Trường	Kiểu	Mô tả
`status`	boolean	Cho biết yêu cầu có hoàn tất thành công hay không.
`used_credits`	integer	Số credit đã dùng cho yêu cầu này.
`remaining_credits`	integer	Số credit còn lại sau yêu cầu.
`expires`	integer	Thời điểm hết hạn gói dưới dạng UNIX timestamp.
`q`	string	Email gốc được gửi trong yêu cầu.
`name`	string	Tên riêng được trích xuất từ địa chỉ email.
`gender`	string \| null	Giá trị dự đoán: male, female hoặc null.
`country`	string	Mã quốc gia được xét khi dự đoán.
`total_names`	integer	Số mẫu dữ liệu hỗ trợ dự đoán.
`probability`	integer	Độ tin cậy của dự đoán theo phần trăm.
`duration`	string	Thời gian xử lý trên máy chủ.

Dùng địa chỉ email đầy đủ và hợp lệ

Khả năng trích xuất tên phụ thuộc vào cấu trúc địa chỉ. Hộp thư chung, bí danh hoặc phần trước @ không có tên dễ nhận biết có thể không trả kết quả; hãy kiểm tra name, gender và probability trước khi dùng dự đoán.

Hướng dẫn tiếp theo

Phân tích nhiều địa chỉ email

Yêu cầu nhiều emailXử lý nhiều địa chỉ trong một yêu cầu →Yêu cầu một tênGửi trực tiếp tên riêng đã biết →