यूज़रनेम से जेंडर प्राप्त करें - मल्टीपल रिक्वेस्ट

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

एपीआई हर यूज़रनेम से संभावित फर्स्ट नेम निकालने की कोशिश करेगा, जिससे जेंडर प्रेडिक्शन की सटीकता बढ़ सकती है। आप प्रत्येक रिकॉर्ड के लिए वैकल्पिक country फ़िल्टर और एक कस्टम id फ़ील्ड भी पास कर सकते हैं, ताकि आप अपने डेटाबेस से परिणामों को मिलान कर सकें।

चेतावनी: यूज़रनेम आमतौर पर लैटिन कैरेक्टर्स में होने चाहिए। हालांकि, इनमें अक्सर ऐसे शब्द या संयोजन होते हैं जो असली नाम नहीं होते, जैसे cool_boy123

अगर आपका मुख्य उद्देश्य जेंडर की सटीक प्रेडिक्शन है, तो हम सिंगल रिक्वेस्ट का उपयोग करने की सलाह देते हैं, जिसमें forceToGenderize पैरामीटर सक्षम हो।

अगर आपकी प्राथमिकता सिर्फ यूज़रनेम से संभावित नाम निकालना है, तो आप मल्टीपल रिक्वेस्ट का उपयोग कर सकते हैं।

रिक्वेस्ट URL

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

आवश्यक HTTP हेडर

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

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

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

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

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

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


cURL उदाहरण

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

PHP cURL उदाहरण

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

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

Python requests उदाहरण

import requests

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

payload = {
    "data": [
        { "username": "anna_smith88", "country": "US", "id": "123" },
        { "username": "michael_bauer", "country": "DE", "id": "456" },
        { "username": "giulia_rossi", "country": "IT", "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": "Anna",
      "q": "anna_smith88",
      "gender": "female",
      "country": "US",
      "total_names": 1234,
      "probability": 92,
      "id": "123"
    },
    {
      "name": "Michael",
      "q": "michael_bauer",
      "gender": "male",
      "country": "DE",
      "total_names": 5678,
      "probability": 89,
      "id": "456"
    },
    {
      "name": "Giulia",
      "q": "giulia_rossi",
      "gender": "female",
      "country": "IT",
      "total_names": 4321,
      "probability": 95,
      "id": "789"
    }
  ],
  "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)।