यूज़रनेम से जेंडर प्राप्त करें - मल्टीपल रिक्वेस्ट
मल्टीपल यूज़रनेम एपीआई एंडपॉइंट आपको एक ही रिक्वेस्ट में अधिकतम 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 )। |