⚡ Unified API v2.0 ADVANCED

API DOCUMENTATION

हमारे high-performance unified API का अनुभव करो, जो ज़्यादा रिक्वेस्ट वॉल्यूम वाले advanced यूज़र्स के लिए डिज़ाइन किया गया है। एक ही रिक्वेस्ट में कई नामों पर क्वेरी करो, वो भी बेहद तेज़ response time के साथ।

ईमेल एड्रेस से क्वेरी करो

तुम ईमेल पते के ज़रिए भी gender की क्वेरी कर सकते हो:

POST https://gender-api.com/v2/gender

info ज़रूरी रिक्वेस्ट्स: 1

http Headers

Content-Type: application/json

Authorization: Bearer <your authorization token>

link

data_object JSON Payload

फ़ील्ड	टाइप करें	ज़रूरी	विवरण
`email`	string	हाँ	जिस ईमेल पते पर क्वेरी करनी है
`country`	string	नहीं	ISO 3166 ALPHA-2 Country Code link
`locale`	string	नहीं	ब्राउज़र लोकेल
`ip`	string	नहीं	वैध IPv4 या IPv6 पता
`id`	string	नहीं	अधिकतम 50 अक्षर। तुम इस आईडी को अपनी पसंद के किसी भी अल्फ़ान्यूमेरिक मान पर सेट कर सकते हो। उदाहरण के लिए, तुम आईडी को अपने डेटाबेस में मौजूद डेटा सेट की इंटरनल आईडी पर सेट कर सकते हो। एक asynchronous वातावरण में यह तुम्हें किसी response को पिछली request से बेहतर ढंग से जोड़ने में मदद करता है

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

arrow_forward सिर्फ़ ईमेल पते से क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

{
    "email": "theresa.miller14@gmail.com"
}

arrow_forward ईमेल पता और country code के साथ क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

arrow_forward ईमेल पता और ब्राउज़र locale के साथ क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

arrow_forward ईमेल पता इस्तेमाल करो और localization के लिए IP address का उपयोग करो

play_arrow Codepen.io पर लाइव ट्राय करो

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

arrow_forward एक ही रिक्वेस्ट में कई नामों की क्वेरी करो

play_arrow Codepen.io पर लाइव ट्राय करो

[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle रिस्पॉन्स

{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

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

फ़ील्ड	टाइप करें	विवरण
`input`	object	भेजा गया payload
`details.credits_used`	int	इस क्वेरी के लिए इस्तेमाल की गई requests की संख्या
`details.samples`	int	हमारे डेटाबेस में तुम्हारी request से मेल खाते हुए मिले रिकॉर्ड्स की संख्या
`details.country`	string	वह देश जो हमें मिला
`details.email_sanitized`	int	वह नाम, जिस पर हमने अपना normalizer लागू किया है
`details.duration`	string	सर्वर को request प्रोसेस करने में लगा समय
`result_found`	bool	True, अगर हम दिए गए नाम के लिए gender क्वेरी करने में सक्षम रहे
`email`	string	वह ईमेल पता जो हमने genderization के लिए इस्तेमाल किया
`probability`	float	यह मान (0 और 1 के बीच) हमारी डेटाबेस की विश्वसनीयता दर्शाता है। मान 1 होने का मतलब है कि तुम्हारी gender request के नतीजे 100%% सटीक हैं।
`gender`	string	संभावित मान: male, female, unknown