ईमेल से जेंडर प्राप्त करें – एकल अनुरोध
Get Gender by Email एंडपॉइंट आपको किसी व्यक्ति के ईमेल पते का विश्लेषण करके उसका जेंडर निर्धारित करने की सुविधा देता है।
सभी पैरामीटर POST अनुरोध के माध्यम से JSON के रूप में भेजे जाते हैं।
आपको Authorization हेडर में Bearer टोकन विधि का उपयोग करके प्रमाणीकरण करना होगा।
रिक्वेस्ट URL
POST https://api.genderapi.io/api/email
आवश्यक HTTP हेडर
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
रिक्वेस्ट बॉडी पैरामीटर
पैरामीटर |
प्रकार |
आवश्यक |
विवरण |
email |
String |
हाँ |
विश्लेषण करने के लिए ईमेल पता। API, जेंडर निर्धारित करने से पहले, ईमेल से संभावित फर्स्ट नेम निकाल लेगा।
|
country |
String |
नहीं |
दो अक्षरों का देश कोड (ISO 3166-1 alpha-2) भविष्यवाणी की सटीकता बढ़ाने के लिए। उदाहरण: TR तुर्की के लिए।
|
askToAI |
Boolean |
नहीं |
यदि true सेट किया गया है, तो API AI मॉडल से जेंडर पता करने के लिए पूछेगा यदि निकाला गया नाम डेटाबेस में नहीं मिलता।
|
रिक्वेस्ट उदाहरण
cURL उदाहरण
curl -X POST "https://api.genderapi.io/api/email" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"email": "michael.smith@example.com", "country": "US", "askToAI": true}'
PHP cURL उदाहरण
<?php
$url = "https://api.genderapi.io/api/email";
$data = array(
"email" => "michael.smith@example.com",
"country" => "US",
"askToAI" => 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/email", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({
email: "michael.smith@example.com",
country: "US",
askToAI: true
})
})
.then(response => response.json())
.then(data => console.log(data));
Python requests उदाहरण
import requests
url = "https://api.genderapi.io/api/email"
payload = {
"email": "michael.smith@example.com",
"country": "US",
"askToAI": True
}
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": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "michael.smith@example.com",
"name": "Michael",
"gender": "male",
"country": "US",
"total_names": 10345,
"probability": 97,
"duration": "5ms"
}
उत्तर फ़ील्ड्स
फ़ील्ड |
प्रकार |
विवरण |
status |
Boolean |
क्या अनुरोध सफल रहा, यह दिखाता है। |
used_credits |
Integer |
इस अनुरोध के लिए उपयोग किए गए क्रेडिट्स की संख्या। |
remaining_credits |
Integer |
इस अनुरोध के बाद आपके खाते में शेष क्रेडिट्स। |
expires |
Integer (timestamp) |
पैकेज की समाप्ति तिथि UNIX timestamp के रूप में। |
q |
String |
आपका इनपुट क्वेरी (भेजा गया ईमेल)। |
name |
String |
ईमेल से निकाला गया फर्स्ट नेम। |
gender |
Enum[String] |
अनुमानित जेंडर। संभावित मान: male , female या null । |
country |
String |
भविष्यवाणी के समय विचार किया गया देश कोड। |
total_names |
Integer |
इस अनुमान के लिए उपयोग किए गए सैंपल्स की संख्या। |
probability |
Integer |
जेंडर अनुमान की संभावना प्रतिशत। |
duration |
String |
अनुरोध को प्रोसेस करने में लगा समय (जैसे 5ms )। |