Cách Sử Dụng Cơ Bản

GenderAPI cho phép bạn xác định giới tính của một người dựa trên nhiều loại dữ liệu đầu vào khác nhau. Bạn có thể phân tích tên riêng trực tiếp hoặc trích xuất tên từ địa chỉ email và username. Dưới đây là cách bắt đầu:

1. Xác Định Giới Tính Từ Tên

Gửi một tên riêng tới endpoint sau:

https://api.genderapi.io/api

Ví dụ:

curl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"

Bạn cũng có thể thêm các tham số tuỳ chọn:

• country: Gửi mã quốc gia 2 chữ cái ( ISO 3166-1 alpha-2 ) để cải thiện độ chính xác của dự đoán. Ví dụ: country=TR cho Thổ Nhĩ Kỳ.
• askToAI: Nếu đặt thành true, API sẽ hỏi mô hình AI để xác định giới tính khi tên không có trong cơ sở dữ liệu.
• forceToGenderize: Nếu đặt thành true, API sẽ cố gắng đoán giới tính ngay cả với những đầu vào không giống tên người thật, như biệt danh hoặc tên tưởng tượng như sparkling unicorn hoặc mystic warrior. Điều này rất hữu ích khi phân tích username, nhưng kết quả có thể ít chính xác hơn. Lưu ý: Tham số này không khả dụng trên endpoint email.

Ví dụ với các tham số:

curl "https://api.genderapi.io/api?name=sparkling%20unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"

2. Xác Định Giới Tính Từ Địa Chỉ Email

Sử dụng endpoint này nếu bạn chỉ có địa chỉ email:

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

Ví dụ:

curl "https://api.genderapi.io/api/email?email=alice.smith@example.com&country=TR&askToAI=true&key=YOUR_API_KEY"

Lưu ý: Tham số forceToGenderize không khả dụng cho endpoint email vì endpoint này sẽ tự động trích xuất tên bên trong.

3. Xác Định Giới Tính Từ Username

Để phân tích username hoặc biệt danh, hãy sử dụng:

https://api.genderapi.io/api/username

Ví dụ:

curl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"

Tham số forceToGenderize đặc biệt hữu ích ở đây vì username thường chứa từ không phải tên hoặc các thuật ngữ tưởng tượng. Nó buộc API cố gắng dự đoán giới tính ngay cả khi đầu vào không phải tên người thông thường.

Tất cả các phương thức đều hỗ trợ yêu cầu đơn hoặc hàng loạt. Để biết thêm chi tiết, hãy xem các phần cụ thể trong menu điều hướng bên trái.

✅ Phản Hồi API

Ví dụ phản hồi JSON cho tất cả các endpoint:

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

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

curl "https://api.genderapi.io/api?name=sparkling unicorn&key=YOUR_API_KEY"

curl "https://api.genderapi.io/api?name=sparkling%20unicorn&key=YOUR_API_KEY"