API giới tính hàng loạt – Phân tích nhiều tên

Tổng quan yêu cầu hàng loạt

Xử lý tối đa 100 tên

Gửi một mảng data và nhận một kết quả cho mỗi bản ghi. Thêm id từ hệ thống của bạn để ghép chính xác từng dự đoán với bản ghi nguồn.

Phương thứcPOST

Tối đa100 tên

Xác thựcBearer token

AI dự phòngKhông hỗ trợ

Yêu cầu hàng loạt không dùng suy luận AI.

Không hỗ trợ askToAI và forceToGenderize. Với tên dùng chữ viết ngoài hệ Latin hoặc dữ liệu cần AI dự phòng, hãy dùng endpoint một tên.

HDR

HTTP header bắt buộc

Xác thực yêu cầu hàng loạt

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

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

Tham số

Trường	Kiểu	Yêu cầu	Mô tả
`data`	object[]	Bắt buộc	Mảng chứa từ 1 đến 100 bản ghi tên.
`data[].name`	string	Bắt buộc	Tên riêng cần phân tích.
`data[].country`	string	Không bắt buộc	Mã quốc gia ISO 3166-1 alpha-2. Nếu không có kết quả theo quốc gia, hệ thống dùng kết quả toàn cầu.
`data[].id`	string \| integer	Không bắt buộc	Mã bản ghi của bạn; được trả về nguyên vẹn để ghép kết quả với dữ liệu đầu vào.

Dự phòng theo quốc gia

Nếu không có kết quả cho quốc gia được gửi, GenderAPI trả về kết quả tên toàn cầu hiện có. Dùng mã ISO 3166-1 alpha-2 như VN, DE hoặc US.

Payload yêu cầu

Tạo mảng data

JSON

{
  "data": [
    { "name": "Linh", "country": "VN", "id": "123" },
    { "name": "Andrea", "country": "IT", "id": "456" },
    { "name": "James", "country": "US", "id": "789" }
  ]
}

Ví dụ mã

Gửi yêu cầu nhiều tên

cURL

curl -X POST "https://api.genderapi.io/api/name/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"name":"Linh","country":"VN","id":"123"},{"name":"Andrea","country":"IT","id":"456"}]}'

JavaScript

const data = [
  { name: "Linh", country: "VN", id: "123" },
  { name: "Andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Phản hồi 200

Ghép kết quả với bản ghi của bạn

JSON

{
  "status": true,
  "used_credits": 2,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "linh", "q": "Linh", "gender": "female", "country": "VN", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "Andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "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 hàng loạt có hoàn tất thành công hay không.
`used_credits`	integer	Tổng số credit đã dùng cho các tên được gửi.
`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.
`names`	object[]	Danh sách kết quả dự đoán theo đúng thứ tự.
`names[].name`	string	Tên chuẩn hóa dùng cho dự đoán.
`names[].q`	string	Tên gốc được gửi trong yêu cầu.
`names[].gender`	string \| null	Giá trị dự đoán: male, female hoặc null.
`names[].country`	string	Mã quốc gia được xét cho kết quả này.
`names[].total_names`	integer	Số mẫu dữ liệu hỗ trợ kết quả.
`names[].probability`	integer	Độ tin cậy của dự đoán theo phần trăm.
`names[].id`	string \| integer	Mã đầu vào được trả lại để đối chiếu bản ghi.
`duration`	string	Tổng thời gian xử lý trên máy chủ.

Giới hạn mỗi yêu cầu ở 100 bản ghi

Kiểm tra mảng trước khi gửi và dùng id duy nhất để ghép bản ghi một cách xác định. Chia tập dữ liệu lớn thành các lô không quá 100 tên.

Hướng dẫn tiếp theo

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

Yêu cầu một emailTrích xuất và phân tích tên từ email →Yêu cầu một tênDùng AI dự phòng cho một tên →