यूज़रनेम द्वारा जेंडर पता करें - एकल अनुरोध
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 )। |