Xác định giới tính từ tối đa 50 tên người dùng

Tổng quan yêu cầu khối lượng

Xử lý đến 50 tên người dùng

Gửi mộtdatamảng. GenderAPI trích xuất các tín hiệu tên tiềm ẩn từ mỗi handle và trả về kết quả với bản ghi tùy chọn của bạnid.

MethodPOST

Maximum50 tên người dùng

Authenticationtoken Bearer

các lựa chọn AIKhông được hỗ trợ

Kết quả tên người dùng hàng loạt cần được kiểm tra cẩn thận.

Các handle có thể chứa thương hiệu, các từ giả tưởng hoặc các từ không liên quan. Các yêu cầu hàng loạt không chấp nhậnaskToAI or forceToGenderize. Để xử lý các đầu vào bất thường với độ tin cậy cao hơn, hãy sử dụngyêu cầu đơn.

HDR

Các tiêu đề HTTP bắt buộc

Xác thực yêu cầu khối lượng

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Thân yêu cầu JSON

Tham số

Field	Type	Requirement	Description
`data`	object[]	Bắt buộc	Mảng chứa từ 1 đến 50 bản ghi tên người dùng.
`data[].username`	string	Bắt buộc	Tên người dùng hoặc tài khoản để phân tích; hỗ trợ dấu gạch dưới và chữ số.
`data[].country`	string	Tùy chọn	Mã quốc gia ISO 3166-1 alpha-2 được sử dụng như bối cảnh khu vực.
`data[].id`	string \| integer	Tùy chọn	Biểu mẫu nhận diện của bạn, được trả về nguyên vẹn cùng kết quả tương ứng.

Hướng dẫn đầu vào

Tên người dùng có ký tự La tinh thường cung cấp tín hiệu tên rõ ràng hơn. Sử dụng các giá trị độc đáo và đánh giá tên đã trích xuấtidtrước khi cập nhật bản ghi.name and probabilityTạo mảng tên người dùng

Nội dung yêu cầu

Xây dựng mảng tên người dùng

JSON

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

Ví dụ mã nguồn

Gửi yêu cầu nhiều tên người dùng

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 })
});

Trả về mã 200

Trích xuất tên và dự đoán

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"
}

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

Field	Type	Description
`status`	boolean	Xem xét liệu yêu cầu khối lượng có hoàn thành thành công hay không.
`used_credits`	integer	Số lượng điểm được sử dụng trong các tên người dùng đã gửi.
`remaining_credits`	integer	Số lượng điểm còn lại sau khi thực hiện yêu cầu.
`expires`	integer	Thời gian hết hạn gói được biểu diễn dưới dạng thời gian UNIX.
`names`	object[]	Kết quả cho các tên người dùng đã gửi.
`names[].name`	string	Tên tiềm năng được trích xuất từ tên người dùng.
`names[].q`	string	Tên người dùng gốc đã được gửi trong yêu cầu.
`names[].gender`	string \| null	Giá trị dự đoán: nam, nữ hoặc null.
`names[].country`	string	Mã quốc gia được xem xét cho kết quả này.
`names[].total_names`	integer	Số mẫu hỗ trợ kết quả này.
`names[].probability`	integer	Độ tin cậy dự đoán dưới dạng phần trăm.
`names[].id`	string \| integer	Mã định danh đầu vào được trả về để liên kết với bản ghi.
`duration`	string	Thời gian xử lý trên máy chủ tổng cộng.

Giữ mỗi yêu cầu trong 50 bản ghi

Chia nhỏ các đầu vào lớn thành các bộ phận. Tên người dùng là tín hiệu gián tiếp, do đó cần xác minh tên đã trích xuất và thiết lập ngưỡng xác suất chấp nhận được trước khi áp dụng kết quả.

Tham chiếu tiếp theo

Xác minh và định dạng số điện thoại

Xác minh số điện thoạiKiểm tra và đánh giá các phương pháp xác minh và định dạng →Username yêu cầu đơnUse các lựa chọn AI for one handle →