Lấy Giới Tính từ Tên Người Dùng - Yêu Cầu Đơn Lẻ

Endpoint Get Gender by Username 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 một tên người dùng hoặc biệt danh. Tất cả các tham số được gửi thông qua 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/username

HTTP Header Bắt Buộc

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

Các Tham Số Trong Body Yêu Cầu

Tham Số Kiểu Dữ Liệu Bắt Buộc Mô Tả
username String Tên người dùng hoặc biệt danh cần phân tích. Có thể là tên tài khoản mạng xã hội, tên hiển thị hoặc bí danh. Có thể chứa những từ không phải tên thật như các từ fantasy hoặc tên thương hiệu.
country String Không Mã quốc gia 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 đặt thành true, API sẽ hỏi mô hình AI để xác định giới tính nếu tên trích xuất được không có trong cơ sở dữ liệu.
forceToGenderize Boolean Không Nếu đặt thành true, API sẽ cố gắng đoán giới tính ngay cả với các username không giống tên người thật, ví dụ như từ fantasy hoặc biệt danh (ví dụ sparkling_unicorn).

Ví Dụ Yêu Cầu


Ví Dụ cURL

curl -X POST "https://api.genderapi.io/api/username" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"username": "sparkling_unicorn", "country": "US", "askToAI": true, "forceToGenderize": true}'

Ví Dụ PHP cURL

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

$data = array(
    "username" => "sparkling_unicorn",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => 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/username", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    username: "sparkling_unicorn",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Ví Dụ Python requests

import requests

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

payload = {
    "username": "sparkling_unicorn",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": 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": "sparkling_unicorn",
  "name": "Sparkling",
  "gender": "female",
  "country": "US",
  "total_names": 9876,
  "probability": 92,
  "duration": "6ms"
}

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

Trường Kiểu Dữ Liệu Mô Tả
status Boolean Cho biết yêu cầu có thành công hay không.
used_credits Integer Số credit đã tiêu tốn 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 bạn gửi vào (tức là username bạn đã gửi).
name String Tên riêng được trích xuất từ username.
gender Enum[String] Giới tính dự đoán. 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 để dự đoán.
probability Integer Tỷ lệ phần trăm độ tin cậy của dự đoán giới tính.
duration String Thời gian xử lý cho yêu cầu (ví dụ: 6ms).