Lấy Giới Tính từ Email - Yêu Cầu Đơn

Endpoint Get Gender by Email cho phép bạn xác định giới tính của một người bằng cách phân tích địa chỉ email của họ. Tất cả các tham số được gửi qua một yêu cầu POST dưới dạng JSON. Bạn phải xác thực bằng phương thức Bearer token trong header Authorization.

URL Yêu Cầu

POST https://api.genderapi.io/api/email

HTTP Header Bắt Buộc

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Tham Số Trong Body Yêu Cầu

Tham Số Kiểu Dữ Liệu Bắt Buộc Mô Tả
email String Địa chỉ email cần phân tích. API sẽ trích xuất tên đầu tiên có khả năng cao nhất từ email trước khi xác định giới tính.
country String Không Mã quốc gia gồm hai ký tự (ISO 3166-1 alpha-2) để tăng độ chính xác của dự đoán. Ví dụ: TR cho Thổ Nhĩ Kỳ.
askToAI Boolean Không Nếu được đặt thành true, API sẽ yêu cầu một mô hình AI xác định giới tính nếu tên trích xuất không tìm thấy trong cơ sở dữ liệu.

Ví Dụ Yêu Cầu


Ví Dụ cURL

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

Ví Dụ PHP cURL

<?php
$url = "https://api.genderapi.io/api/email";

$data = array(
    "email" => "michael.smith@example.com",
    "country" => "US",
    "askToAI" => true
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Ví Dụ JavaScript fetch

fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    email: "michael.smith@example.com",
    country: "US",
    askToAI: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Ví Dụ Python requests

import requests

url = "https://api.genderapi.io/api/email"

payload = {
    "email": "michael.smith@example.com",
    "country": "US",
    "askToAI": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Ví Dụ JSON Phản Hồi

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "michael.smith@example.com",
  "name": "Michael",
  "gender": "male",
  "country": "US",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

Các Trường Trong Phản Hồi

Trường Kiểu Dữ Liệu Diễn Giải
status Boolean Cho biết yêu cầu có thành công hay không.
used_credits Integer Số credit đã sử dụng cho yêu cầu này.
remaining_credits Integer Số credit còn lại trong tài khoản sau yêu cầu này.
expires Integer (timestamp) Ngày hết hạn gói dịch vụ dưới dạng UNIX timestamp.
q String Truy vấn đầu vào của bạn (email đã gửi).
name String Tên đầu tiên được trích xuất từ địa chỉ email.
gender Enum[String] Giới tính được dự đoán. Các giá trị có thể là: male, female, hoặc null.
country String Mã quốc gia được xem xét trong quá trình dự đoán.
total_names Integer Số lượng mẫu tên được sử dụng cho dự đoán này.
probability Integer Tỷ lệ phần trăm độ tin cậy cho dự đoán giới tính.
duration String Thời gian xử lý yêu cầu (ví dụ: 5ms).