यूज़रनेम द्वारा जेंडर पता करें - एकल अनुरोध

Get Gender by Username एंडपॉइंट आपको किसी व्यक्ति का जेंडर पता करने की अनुमति देता है, यूज़रनेम या उपनाम का विश्लेषण करके। सभी पैरामीटर एक POST अनुरोध के जरिए JSON फॉर्मेट में भेजे जाते हैं। आपको Authorization हेडर में Bearer टोकन पद्धति का उपयोग करके प्रमाणीकरण करना होगा।

रिक्वेस्ट URL

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

आवश्यक HTTP हेडर

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

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

पैरामीटर टाइप आवश्यक विवरण
username String हाँ वह यूज़रनेम या उपनाम जिसे आप एनालाइज़ करना चाहते हैं। यह किसी सोशल मीडिया का हैंडल, स्क्रीन नाम या उपनाम हो सकता है। इसमें ऐसे शब्द भी हो सकते हैं जो असली नाम न हों, जैसे फैंटेसी शब्द या ब्रांड रेफरेंस।
country String नहीं दो अक्षरों का कंट्री कोड (ISO 3166-1 alpha-2) ताकि भविष्यवाणी की सटीकता बढ़ाई जा सके। उदाहरण: TR तुर्की के लिए।
askToAI Boolean नहीं अगर इसे true पर सेट किया गया है, तो API एक AI मॉडल से जेंडर का निर्धारण करवाएगा यदि निकाला गया नाम डेटाबेस में नहीं मिला।
forceToGenderize Boolean नहीं अगर इसे true पर सेट किया गया है, तो API ऐसे यूज़रनेम के लिए भी जेंडर का अनुमान लगाने की कोशिश करेगा जो असली नाम की तरह नहीं दिखते, जैसे फैंटेसी शब्द या उपनाम (उदा. sparkling_unicorn)।

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


cURL उदाहरण

curl -X POST "https://api.genderapi.io/api/username" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"username": "sparkling_unicorn", "country": "US", "askToAI": true, "forceToGenderize": true}'

PHP cURL उदाहरण

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

$data = array(
    "username" => "sparkling_unicorn",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$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", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    username: "sparkling_unicorn",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests उदाहरण

import requests

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

payload = {
    "username": "sparkling_unicorn",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

उदाहरण JSON Response

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "sparkling_unicorn",
  "name": "Sparkling",
  "gender": "female",
  "country": "US",
  "total_names": 9876,
  "probability": 92,
  "duration": "6ms"
}

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

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