ईमेल से जेंडर प्राप्त करें – एकल अनुरोध

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)।