Xác định giới tính từ tối đa 50 địa chỉ email

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

Xử lý đến 50 địa chỉ email

Gửi mộtdatamảng. GenderAPI trích xuất một tên có khả năng từ mỗi địa chỉ và trả về dự đoán tương ứng; tùy chọn của bạnidlàm cho việc tương thích cơ sở dữ liệu trở nên xác định.

MethodPOST

Maximum50 email

Authenticationtoken Bearer

Định dạng kết quảnames[]

50 email maxTrích xuất tênKết quả có nhận diện quốc gia

HDR

Các tiêu chí 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 email.
`data[].email`	string	Bắt buộc	Địa chỉ email mà GenderAPI trích xuất tên đầu tiên có khả năng.
`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	Mã định danh bản ghi của bạn, được trả về nguyên vẹn cùng kết quả tương ứng.

Sự khớp của bản ghi

Sử dụng một giá trị duy nhấtidVới mỗi mục. GenderAPI trả về mục đó cùng kết quả của mục đó, giúp bạn cập nhật bản ghi cơ sở dữ liệu đúng mà không cần dựa vào vị trí trong mảng.

Dữ liệu yêu cầu

Xây dựng mảng email

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Ví dụ mã

Gửi yêu cầu nhiều email

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Trả về 200

Tên đã trích xuất và dự đoán

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

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

Field	Type	Description
`status`	boolean	Có hay không việc yêu cầu khối đã hoàn thành thành công.
`used_credits`	integer	Số lượng điểm được sử dụng trong tất cả các email đã 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 dịch vụ dưới dạng thời gian UNIX.
`names`	object[]	Tập hợp kết quả được sắp xếp theo thứ tự được gửi trong các email.
`names[].name`	string	Họ được trích xuất từ địa chỉ email.
`names[].q`	string	Email 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ố lượng 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ủ.

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

Xác minh từng địa chỉ và chia các tập dữ liệu lớn thành các lô không quá 50. Kiểm tra phần trích xuấtname and probabilitytrước khi áp dụng kết quả.

Hướng dẫn tiếp theo

Xác định giới tính từ một tên người dùng

Yêu cầu một tên người dùngTrích xuất tên từ một tên người dùng →Yêu cầu email một người dùngSử dụng fallback AI cho một email →