รับข้อมูลเพศจากชื่อ - คำขอหลายรายการ

Multiple Names endpoint ช่วยให้คุณสามารถวิเคราะห์เพศจากชื่อได้สูงสุด 100 รายการในการร้องขอเดียว ซึ่งเหมาะสำหรับการประมวลผลจำนวนมากและการรวมระบบที่มีประสิทธิภาพสูง พารามิเตอร์ทั้งหมดจะถูกส่งผ่านคำขอแบบ POST เป็น JSON คุณต้องยืนยันตัวตนโดยใช้ Bearer token ผ่าน Authorization header

โดยการเพิ่มพารามิเตอร์ country สำหรับแต่ละชื่อ คุณสามารถรับการคาดการณ์เพศ ที่เฉพาะเจาะจงตามประเทศได้ หากไม่มีผลลัพธ์สำหรับประเทศนั้น API จะให้ผลลัพธ์ในระดับโลกแทน

คุณยังสามารถส่งพารามิเตอร์ id เพิ่มเติมสำหรับแต่ละชื่อได้อีกด้วย ค่านี้สามารถเป็น string หรือ integer ที่คุณกำหนดเองจากฐานข้อมูลของคุณ API จะส่งคืนค่า id เดิมกลับมาในผลลัพธ์เพื่อให้คุณจับคู่ข้อมูลได้อย่างถูกต้อง

Request URL

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

HTTP Headers ที่จำเป็น

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

Request Body Parameters

ตัวอย่าง Request Body

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

ตัวอย่างการร้องขอ (Example Requests)

ตัวอย่าง 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"}]}'

ตัวอย่าง 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;
?>

ตัวอย่าง 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));

ตัวอย่าง 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())

ตัวอย่าง JSON การตอบกลับ

{
  "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"
}

ฟิลด์ในคำตอบ (Response Fields)