V2 API आज़माएँ
ईमेल पते का विश्लेषण करें
एक मान भेजें और पूरा रिस्पॉन्स देखें, अज्ञात परिणाम और इस्तेमाल हुए क्रेडिट सहित।
नीचे दिया गया रिस्पॉन्स 1 अक्टूबर 2026 को लिया गया असली रिस्पॉन्स है। अनुरोध भेजने के लिए “विश्लेषण करें” चुनें।
| नाम | Pooja |
|---|---|
| लिंग | महिला |
| विश्वास स्तर | 98% |
| स्रोत | AI मॉडल |
| इस्तेमाल हुए क्रेडिट | 2 |
{
"data": {
"input": {
"type": "email",
"value": "pooja.sharma@example.com",
"country": null
},
"name": "pooja",
"gender": "female",
"country": null,
"confidence": 0.98,
"confidence_kind": "model_reported",
"sample_count": null,
"source": "ai",
"result_status": "identified",
"reason": null,
"country_source": null,
"match": {
"name": null,
"method": "model_inference",
"scope": null,
"country": null
}
},
"meta": {
"request_id": "e08ed4f1-1af4-4c17-aecf-da051ea4aedf",
"duration_ms": 390,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 2,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}यह असली रिस्पॉन्स 1 अक्टूबर 2026 को लिया गया था; सिर्फ़ खाते का बैलेंस बदला गया है। लाइव मान अलग हो सकते हैं। अनुमान पुष्टि की गई पहचान नहीं है।
यह कैसे काम करता है
ईमेल पते से संरचित डेटा तक
इंटीग्रेशन के तरीके
चुनें कि ईमेल डेटा कहाँ प्रोसेस करना है
Microsoft Excel
Excel ऐड-इन से ईमेल पतों का कॉलम प्रोसेस करें
ईमेल पते की प्रोसेसिंग का तरीका चुनें, फिर स्रोत कॉलम और परिणाम फ़ील्ड मैप करें। सेल में डायनेमिक क्वेरी के लिए GENDER.FROM_EMAIL इस्तेमाल करें और स्थायी परिणामों के लिए साइडबार।
Google Sheets
ऐड-ऑन या फ़ॉर्मूला से ईमेल पतों का विश्लेषण करें
मौजूदा पंक्तियों के लिए ऐड-ऑन, नई पंक्तियों के लिए संगत वर्कफ़्लो और एक सेल की क्वेरी के लिए GENDER फ़ॉर्मूला इस्तेमाल करें।
REST API
ईमेल पतों का विश्लेषण अपने बैकएंड में जोड़ें
प्रमाणित ईमेल पता एंडपॉइंट को सर्वर से कॉल करें और API कुंजी को ब्राउज़र या सार्वजनिक कोड में न डालें। रिस्पॉन्स का ढाँचा, त्रुटि कोड और क्रेडिट का इस्तेमाल साफ़ तौर पर संभालें।

सटीकता और ज़िम्मेदार इस्तेमाल
पते में नाम न हो, तो परिणाम ज़बरदस्ती न निकालें
भूमिका वाले पते, बेतरतीब पहचानकर्ता और साझा इनबॉक्स हमेशा भरोसेमंद संकेत नहीं देते। data.result_status, data.reason और data.confidence सुरक्षित रखें और अनिश्चित परिणामों को अलग से संभालें।
V2 पर अमल की गाइड
स्रोत डेटा और अनुमान को अलग-अलग सेव करें
मूल रिकॉर्ड का पहचानकर्ता सुरक्षित रखें। API कोई प्रोफ़ाइल नहीं खोलता, अकाउंट के मालिक की पुष्टि नहीं करता और किसी की पहचान सत्यापित नहीं करता। देश का संदर्भ तभी भेजें जब वह भरोसेमंद जानकारी से आया हो; उसे डोमेन या वेबसाइट की भाषा से अनुमानित न करें।
| रिकॉर्ड | फ़ील्ड | व्याख्या |
|---|---|---|
| स्रोत रिकॉर्ड | contact_id / original_email | स्रोत डेटा अपने सिस्टम में रखें और व्यक्ति के दिए गए पहले नाम को अनुमान से न बदलें। ये API रिस्पॉन्स के फ़ील्ड नहीं हैं। |
| संभावित पहला नाम | data.name / data.match | चुना गया नाम null हो सकता है। रिस्पॉन्स में सत्यापित उपनाम का कोई फ़ील्ड नहीं है, और मिलान से ईमेल पते के मालिक की पहचान साबित नहीं होती। |
| अनुमान | data.gender / data.result_status / data.reason | अज्ञात परिणाम JSON में null के रूप में दर्ज होता है। डेटासेट में बराबरी वाली पंक्ति में नाम मिल सकता है, पर लिंग नहीं। |
| आधार | data.source / data.confidence_kind / data.confidence / data.sample_count | confidence मान 0 से 1 के बीच होता है। डेटासेट की आवृत्ति और AI स्कोर अलग-अलग चीज़ें मापते हैं; AI परिणाम में sample_count null होता है। |
| प्रक्रिया का रिकॉर्ड | meta.request_id / meta.usage | अनुरोध ID और बिलिंग की स्थिति सेव करें। रिस्पॉन्स न मिलने का मतलब यह नहीं है कि प्रक्रिया मुफ़्त थी या विफल हुई। |
डेटासेट में खोज @ से पहले वाले हिस्से का विश्लेषण करती है, + से शुरू होने वाला प्रत्यय हटाती है और संभावित पहले नामों का आकलन करती है। सामान्य अनुरोध जुड़े हुए हिस्सों के आगे और पीछे के भाग से सीमित संख्या में अतिरिक्त संभावित नाम भी जोड़ सकता है। कई पंक्तियाँ मिलने पर सबसे ज़्यादा दर्ज उपस्थिति वाली पंक्ति चुनी जाती है; ज़रूरी नहीं कि वह व्यक्ति का असली पहला नाम हो। अगर आप देश भेजते हैं, तो हर संभावित नाम के लिए पहले उस देश की पंक्ति इस्तेमाल होती है; वह न हो, तो वैश्विक पंक्ति इस्तेमाल हो सकती है। data.match.scope और country_source जाँचें।
प्रोसेसिंग मोड और क्रेडिट की लागत चुनें
| विकल्प | प्रोसेसिंग | हर पूरे हुए आइटम की लागत |
|---|---|---|
| options.ai_mode: off | केवल डेटासेट | 1 क्रेडिट |
| options.ai_mode: fallback | पहले डेटासेट; लिंग तय न हो, तो सामान्य AI फ़ॉलबैक | AI सहित कुल 1 क्रेडिट |
| options.ai_mode: always | सीधे AI | 2 क्रेडिट |
| forceToGenderize: true | पहले डेटासेट; फिर असली पहले नाम के बिना निकनेम की व्याख्या | डेटासेट काफ़ी हो, तो 1 क्रेडिट; AI इस्तेमाल होने पर कुल 2 क्रेडिट |
एकल अनुरोध का डिफ़ॉल्ट fallback है; बैच अनुरोध के आइटम का डिफ़ॉल्ट off है। forceToGenderize नाम, ईमेल पते और यूज़रनेम, तीनों के लिए वैकल्पिक है; इसके साथ ai_mode छोड़ दें या fallback सेट करें, क्योंकि इसे off या always के साथ नहीं जोड़ा जा सकता। पूरे हुए unknown परिणाम पर भी शुल्क लगता है। अनुरोध शुरू करने के लिए धनात्मक बैलेंस काफ़ी है; प्रक्रिया पूरी होने के बाद बैलेंस ऋणात्मक हो सकता है।
AI इस्तेमाल होने पर उसे आपका भेजा गया पूरा पता मिलता है, डोमेन और + प्रत्यय सहित, भले ही उसे इन हिस्सों को अनदेखा करने का निर्देश दिया गया हो। forceToGenderize असली पहला नाम मिले बिना भी लिंग दे सकता है; इसका मतलब यह नहीं है कि आपके CRM के लिए कोई सत्यापित पहला नाम निकाल लिया गया है।
पहले केवल डेटासेट वाला एक ईमेल अनुरोध आज़माएँ
उदाहरण इनपुट किसी तय अनुमान की गारंटी नहीं देते। GENDERAPI_API_KEY को सर्वर के वातावरण में सेट करें और कुंजी को सार्वजनिक क्लाइंट कोड में न रखें। V1 और V2 एक ही अकाउंट की API कुंजी और एक ही बैलेंस इस्तेमाल करते हैं। कुंजी /api/v2/usage से जाँचें और पुष्टि करें कि meta.access.mode का मान api_key है।
अपनी प्रोग्रामिंग भाषा चुनें। अपनी API कुंजी सेट करें, फिर अपने सर्वर पर उदाहरण चलाएँ।
अनुमान का हर अनुरोध, दोबारा प्रयास सहित, शुल्क वाली नई प्रक्रिया है। ये उदाहरण अपने-आप दोबारा प्रयास नहीं करते। दूसरा अनुरोध भेजने से पहले बिलिंग स्टेटस देखें।
चलाने से पहले: एक्सेस और त्रुटियों को संभालना
ये उदाहरण अपने सर्वर पर चलाएँ। प्रोसेस एनवायरनमेंट में GENDERAPI_API_KEY को अपनी मौजूदा API कुंजी पर सेट करें। पक्का करें कि meta.access.mode का मान api_key है: पहचानी न गई कुंजी IP ट्रायल पर जा सकती है।
HTTP 4xx और 5xx वाले JSON रिस्पॉन्स में त्रुटि की बॉडी बनी रहती है और प्रोग्राम शून्य से अलग एग्ज़िट स्टेटस लौटाता है। दोबारा प्रयास से पहले code, action और meta.usage.billing_status देखें।
त्रुटियों और दोबारा प्रयास की गाइड →POSIX शेल में cURL 7.76+। अपने टर्मिनल में चलाएँ। रनटाइम दस्तावेज़ीकरण
Node.js 22+; बिल्ट-इन fetch। example.mjs के रूप में सेव करें और node example.mjs चलाएँ। रनटाइम दस्तावेज़ीकरण
Python 3.10+; स्टैंडर्ड लाइब्रेरी। example.py के रूप में सेव करें और python3 example.py चलाएँ। रनटाइम दस्तावेज़ीकरण
cURL एक्सटेंशन के साथ PHP 8+। example.php के रूप में सेव करें और php example.php चलाएँ। रनटाइम दस्तावेज़ीकरण
Java 17+; स्टैंडर्ड HTTP क्लाइंट। GenderApiExample.java के रूप में सेव करें और java GenderApiExample.java चलाएँ। रनटाइम दस्तावेज़ीकरण
.NET 8+ कंसोल ऐप्लिकेशन। कंसोल प्रोजेक्ट में Program.cs के रूप में इस्तेमाल करें, फिर dotnet run चलाएँ। रनटाइम दस्तावेज़ीकरण
Go 1.22+; स्टैंडर्ड लाइब्रेरी। main.go के रूप में सेव करें और go run main.go चलाएँ। रनटाइम दस्तावेज़ीकरण
सूची के परिणाम और दोहराए गए अनुरोध संभालें
POST /api/v2/gender/batch API कुंजी के साथ अधिकतम 50 आइटम और IP ट्रायल में अधिकतम 10 आइटम स्वीकार करता है। हर आइटम के लिए type, value और options अलग से दें। सामान्य AI फ़ॉलबैक चाहिए, तो हर आइटम में fallback साफ़ तौर पर सेट करें। id एक ही बैच में अद्वितीय होना चाहिए; index भेजे गए बैच में शून्य से शुरू होता है। अपने काम का पहचानकर्ता और स्रोत पंक्ति का पहचानकर्ता अलग से सेव करें।
HTTP 200 का मतलब यह नहीं है कि सभी आइटम पूरे हो गए। identified, unknown और error परिणामों को अलग-अलग संभालें; meta.summary.succeeded में identified और unknown दोनों गिने जाते हैं। data.gender, source, confidence_kind, confidence, match और reason को साथ मिलाकर देखें। AI स्कोर और डेटासेट की आवृत्ति को एक जैसा न मानें।
अगर meta.usage.billing_status का मान confirmed है, तो केवल उन्हीं प्रक्रिया त्रुटियों को दोबारा भेजें जिनके लिए यह अनुमति है। अगर स्थिति unconfirmed है या रिस्पॉन्स नहीं मिला, तो रुकें और बिलिंग जाँचें। उसी आइटम को दोबारा भेजना, पूरे हुए unknown परिणाम सहित, एक नई शुल्क वाली प्रक्रिया है; पूरी सूची को बिना सोचे दोबारा कभी न भेजें।
बैच अनुरोध के नियम · रिस्पॉन्स फ़ील्ड · AI विकल्प · सटीकता और confidence का आकलन · प्राइवेसी पॉलिसी
Excel ऐड-इन, Google Sheets ऐड-ऑन और दूसरे तैयार इंटीग्रेशन अपने कनेक्शन और परिणाम फ़ॉर्मेट इस्तेमाल कर सकते हैं। यह न मानें कि उनका आउटपुट इसी V2 JSON ढाँचे पर चलता है; संबंधित इंटीग्रेशन की मौजूदा गाइड देखें।
अक्सर पूछे जाने वाले सवाल
ईमेल पते से पहला नाम और लिंग
क्या ईमेल पते से पहला नाम निकाला जा सकता है?
समर्थित व्यक्तिगत ईमेल पतों में GenderAPI @ से पहले वाले हिस्से से संभावित पहला नाम निकाल सकता है और परिणाम मिलने पर लिंग, देश और confidence की जानकारी लौटाता है। संभावित नाम एक अनुमान है, ईमेल पते के मालिक का सत्यापित नाम नहीं।
क्या हर ईमेल पते से नाम मिलता है?
नहीं। भूमिका वाले पते, बेतरतीब पहचानकर्ता और @ से पहले का ऐसा हिस्सा जिसमें असली नाम न हो, हमेशा भरोसेमंद संकेत नहीं देते। V2 रिस्पॉन्स में data.result_status, data.reason, data.confidence और data.confidence_kind जाँचें।
क्या ईमेल क्वेरी सेव की जाती हैं?
प्रकाशित नीति के अनुसार ईमेल क्वेरी पुन: उपयोग योग्य क्वेरी रिकॉर्ड के रूप में नहीं रखी जातीं। अलग तकनीकी और सुरक्षा लॉग प्राइवेसी पॉलिसी में बताई गई प्रतिधारण अवधि का पालन करते हैं। सार्वजनिक डेमो में संवेदनशील व्यक्तिगत डेटा न डालें।
क्या इसे Excel और Google Sheets में इस्तेमाल किया जा सकता है?
हाँ। ईमेल पतों का कॉलम Excel ऐड-इन, Google Sheets ऐड-ऑन या Excel/CSV फ़ाइल अपलोड टूल से प्रोसेस किया जा सकता है। इन इंटीग्रेशन के अपने परिणाम फ़ॉर्मेट हैं, जो V2 JSON से अलग हैं।
API कौन-से फ़ील्ड लौटाता है?
V2 data.name, data.gender, data.match और स्रोत व confidence के फ़ील्ड लौटाता है, और meta में अनुरोध ID व क्रेडिट का इस्तेमाल बताता है। संभावित नाम या लिंग null हो सकता है। रिस्पॉन्स में सत्यापित उपनाम का कोई फ़ील्ड नहीं है।
AI कब इस्तेमाल होता है?
V2 के एकल अनुरोध में सामान्य AI फ़ॉलबैक डिफ़ॉल्ट रूप से चालू रहता है। इस डेमो में आप सामान्य अनुरोध या forceToGenderize इस्तेमाल कर सकते हैं; off और always API अनुरोध में सेट किए जाते हैं। सामान्य AI फ़ॉलबैक पर कुल 1 क्रेडिट और always पर 2 क्रेडिट लगते हैं। forceToGenderize के साथ डेटासेट से परिणाम मिलने पर 1 क्रेडिट और AI इस्तेमाल होने पर कुल 2 क्रेडिट लगते हैं; परिणाम फिर भी unknown हो सकता है।
क्या इसे मुफ़्त में आज़माया जा सकता है?
अकाउंट में हर दिन 200 मुफ़्त क्रेडिट मिलते हैं, और साझा IP ट्रायल हर सार्वजनिक IP पते को 24 घंटे की अवधि में 10 क्रेडिट देता है। API कुंजी न होने या पहचानी न जाने पर IP ट्रायल इस्तेमाल हो सकता है; रिस्पॉन्स में meta.access.mode फ़ील्ड देखें। यहाँ क्रेडिट गिने जाते हैं, अनुरोधों की संख्या नहीं।
