नाम से लिंग प्राप्त करें - मल्टीपल रिक्वेस्ट

Multiple Names एंडपॉइंट आपको एक ही रिक्वेस्ट में अधिकतम 100 नामों का लिंग एनालाइज़ करने की सुविधा देता है। यह बल्क प्रोसेसिंग और हाई-परफॉर्मेंस इंटीग्रेशन के लिए उपयोगी है। सभी पैरामीटर एक POST रिक्वेस्ट के जरिए JSON के रूप में भेजे जाते हैं। आपको Authorization हेडर में Bearer टोकन विधि का उपयोग करके प्रमाणित करना होगा।

प्रत्येक नाम में country फ़िल्टर जोड़कर, आप किसी विशेष देश के लिए लिंग की भविष्यवाणी प्राप्त कर सकते हैं। यदि दिए गए देश के लिए कोई परिणाम नहीं मिलता है, तो API वैश्विक नाम परिणाम लौटाएगा।

आप प्रत्येक नाम के लिए एक वैकल्पिक id फ़ील्ड भी भेज सकते हैं। यह वैल्यू आपकी खुद की डेटाबेस से कोई भी स्ट्रिंग या नंबर हो सकता है। API उसी id को रिस्पॉन्स में लौटाएगा, जिससे आप अपनी इनपुट को परिणामों से मैच कर सकते हैं।

चेतावनी: मल्टीपल रिक्वेस्ट में AI-आधारित अनुमान मॉडल समर्थित नहीं हैं। askToAI जैसे पैरामीटर बल्क ऑपरेशंस में उपलब्ध नहीं हैं।

यदि आपके डेटा में अक्सर गैर-लैटिन वर्णों (जैसे चीनी) में नाम होते हैं, तो हम सिंगल रिक्वेस्ट भेजने और askToAI पैरामीटर का उपयोग करने की सलाह देते हैं ताकि अधिक सटीक परिणाम मिलें।

रिक्वेस्ट URL

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

आवश्यक HTTP हेडर

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

रिक्वेस्ट बॉडी पैरामीटर

फ़ील्ड टाइप आवश्यक विवरण
data ऑब्जेक्ट्स की सूची (Array) हाँ नामों और उनके वैकल्पिक पैरामीटर की सूची। प्रति रिक्वेस्ट अधिकतम 100 एंट्री।
name String हाँ (प्रत्येक ऑब्जेक्ट में) जिस नाम का लिंग आप जानना चाहते हैं।
country String नहीं दो-अक्षरों का देश कोड (ISO 3166-1 alpha-2) भविष्यवाणी की सटीकता बढ़ाने के लिए। उदाहरण: TR तुर्की के लिए।
id String या Integer नहीं वैकल्पिक ID जिसे आप अपने डेटाबेस रिकॉर्ड से मैच करने के लिए परिभाषित करते हैं। वही id रिस्पॉन्स में लौटाई जाती है।

रिक्वेस्ट बॉडी उदाहरण

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

रिक्वेस्ट के उदाहरण


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

रिस्पॉन्स फ़ील्ड्स

फ़ील्ड टाइप विवरण
status Boolean क्या रिक्वेस्ट सफल रही या नहीं यह दर्शाता है।
used_credits Integer इस रिक्वेस्ट के लिए उपयोग किए गए क्रेडिट्स की संख्या।
remaining_credits Integer रिक्वेस्ट के बाद आपके खाते में बचे हुए क्रेडिट्स।
expires Integer (timestamp) आपके पैकेज की समाप्ति तिथि UNIX टाइमस्टैम्प के रूप में।
names ऑब्जेक्ट्स की सूची हर इनपुट नाम के लिए परिणामों की सूची।
names[].name String नाम का सामान्यीकृत (लोअरकेस) संस्करण।
names[].q String आपकी ओर से भेजा गया ओरिजिनल क्वेरी (केस-सेंसिटिव)।
names[].gender Enum[String] अनुमानित लिंग: male, female या null
names[].country String भविष्यवाणी के दौरान विचार किया गया देश कोड।
names[].total_names Integer इस भविष्यवाणी के लिए उपयोग किए गए सैंपलों की संख्या।
names[].probability Integer लिंग भविष्यवाणी के लिए विश्वास प्रतिशत।
names[].id String / Integer वही id जो आपने रिक्वेस्ट में भेजी थी। आपके रिकॉर्ड्स को मैच करने के लिए।
duration String रिक्वेस्ट प्रोसेसिंग में लगा कुल समय (जैसे 5ms)।
चेतावनी: यदि आप मल्टीपल नाम भेजते हैं, तो सुनिश्चित करें कि आपका JSON array सही फॉर्मेट में है और 100 से अधिक नाम नहीं हैं। अपने खुद के रिकॉर्ड्स को API के परिणामों से मैच करने के लिए id फ़ील्ड का उपयोग करें।