Lấy Giới Tính từ Tên - Yêu Cầu Nhiều

Endpoint Multiple Names cho phép bạn phân tích giới tính của tối đa 100 tên trong một lần yêu cầu. Điều này rất hữu ích cho xử lý hàng loạt và các tích hợp có hiệu suất cao. Tất cả các tham số được gửi 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.

Bằng cách thêm bộ lọc country cho từng tên, bạn có thể nhận được kết quả dự đoán giới tính dành riêng cho một quốc gia nhất định. Nếu không có kết quả cho quốc gia đó, API sẽ trả về kết quả tên toàn cầu.

Bạn cũng có thể gửi trường id tùy chọn cho từng tên. Giá trị này có thể là bất kỳ chuỗi hoặc số nguyên nào từ cơ sở dữ liệu của bạn. API sẽ trả lại cùng một id trong phản hồi, để bạn có thể đối chiếu dữ liệu đầu vào với kết quả.

URL Yêu Cầu

POST https://api.genderapi.io/api/name/multi/country

HTTP Header Bắt Buộc

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

Tham Số Trong Body Yêu Cầu

Ví Dụ Body Yêu Cầu

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "andrea", "country": "IT", "id": "456" },
    { "name": "james", "country": "US", "id": "789" }
  ]
}

Ví Dụ Yêu Cầu

Ví Dụ cURL

curl -X POST "https://api.genderapi.io/api/name/multi/country" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"data":[{"name":"Andrea","country":"DE","id":"123"},{"name":"andrea","country":"IT","id":"456"},{"name":"james","country":"US","id":"789"}]}'

Ví Dụ PHP cURL

<?php
$url = "https://api.genderapi.io/api/name/multi/country";

$data = array(
    "data" => array(
        array(
            "name" => "Andrea",
            "country" => "DE",
            "id" => "123"
        ),
        array(
            "name" => "andrea",
            "country" => "IT",
            "id" => "456"
        ),
        array(
            "name" => "james",
            "country" => "US",
            "id" => "789"
        )
    )
);

$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/name/multi/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    data: [
      { name: "Andrea", country: "DE", id: "123" },
      { name: "andrea", country: "IT", id: "456" },
      { name: "james", country: "US", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Ví Dụ Python requests

import requests

url = "https://api.genderapi.io/api/name/multi/country"

payload = {
    "data": [
        { "name": "Andrea", "country": "DE", "id": "123" },
        { "name": "andrea", "country": "IT", "id": "456" },
        { "name": "james", "country": "US", "id": "789" }
    ]
}

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": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    {
      "name": "andrea",
      "q": "Andrea",
      "gender": "female",
      "country": "DE",
      "total_names": 644,
      "probability": 88,
      "id": "optional"
    },
    {
      "name": "andrea",
      "q": "andrea",
      "gender": "male",
      "country": "IT",
      "total_names": 13537,
      "probability": 98,
      "id": "optional"
    },
    {
      "name": "james",
      "q": "james",
      "gender": "male",
      "country": "US",
      "total_names": 45274,
      "probability": 100,
      "id": "optional"
    }
  ],
  "duration": "5ms"
}

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