API दस्तावेज़
त्रुटि कोड्स
errno | errmsg | विवरण |
---|---|---|
50 | access denied | अनधिकृत IP पता या रेफरर। कृपया अपनी पहुँच विशेषाधिकारों की जाँच करें। |
90 | invalid country code | समर्थित देश कोड की जाँच करें। ISO 3166-1 alpha-2 |
91 | name not set || email not set | आपके अनुरोध में नाम या ईमेल पैरामीटर गायब है। |
92 | too many names || too many emails | एक अनुरोध में नामों की सीमा 100 है, ईमेल्स की 50। |
93 | limit reached | API कुंजी के क्रेडिट समाप्त हो चुके हैं। |
94 | invalid or missing key | API कुंजी नहीं मिली। |
99 | API key has expired | कृपया अपनी API कुंजी को नवीनीकृत करें। |
Postman
- 1. पोस्टमैन कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें (लिंक पर राइट क्लिक करें और 'Save As' चुनें)। पोस्टमैन खोलें, File -> Import पर क्लिक करें।
- 2. 'GenderAPI.io' नामक रूट फ़ोल्डर पर क्लिक करें।
- 3. Authorization टैब पर क्लिक करें और अपनी API कुंजी चिपकाएं। रजिस्टर करें और प्रतिदिन 200 मुफ्त क्रेडिट पाएं।

नाम से लिंग
एकल नाम
एकल नाम अनुरोध का मूल उपयोग
GET /api/?name=Anna&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
name=Anna&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
duration | String | milliseconds "4ms" | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
देश फ़िल्टर के साथ एकल नाम
एक देश में एक नाम महिला हो सकता है जबकि किसी अन्य देश में वह पुरुष हो सकता है।
अपनी क्वेरी में देश फ़िल्टर जोड़कर आप उस देश के अनुसार लिंग जानकारी प्राप्त कर सकते हैं।
ISO 3166-1 alpha-2 देश कोड देखें।
* यदि दिए गए देश फ़िल्टर के साथ कोई परिणाम नहीं मिलता है, तो हम वैश्विक नाम परिणाम प्रदान करेंगे।
GET /api/?name=Anna&country=US&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
name=Anna&country=US&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
duration | String | milliseconds "4ms" | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
एकाधिक नाम
आप एक ही बार में कई नामों का अनुरोध कर सकते हैं। अधिकतम सीमा 100 है।
GET /api/?name[]=Anna&name[]=james&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
name=Anna&name=james&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
names | Array | Any | आपके परिणामों की सूची |
duration | String | milliseconds("4ms") | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
names(Array) | |||
---|---|---|---|
फ़ील्ड | डेटा प्रकार | मान | विवरण |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
देश फ़िल्टर के साथ एकाधिक नाम
एक देश में एक नाम महिला हो सकता है जबकि किसी अन्य देश में वह पुरुष हो सकता है।
अपनी क्वेरी में देश फ़िल्टर जोड़कर आप उस देश के अनुसार लिंग जानकारी प्राप्त कर सकते हैं।
ISO 3166-1 alpha-2 देश कोड देखें।
* यदि दिए गए देश फ़िल्टर के साथ कोई परिणाम नहीं मिलता है, तो हम वैश्विक नाम परिणाम प्रदान करेंगे।
* आप एक ही बार में कई नामों का अनुरोध कर सकते हैं। अधिकतम सीमा 100 है।
POST /api/name/multi/country HTTP/1.1
Host: api.genderapi.io
Content-Type: application/json
{
"key":"<YourAPIkey>",
"data":[
{"name":"Andrea", "country":"DE", "id":"optional"},
{"name":"andrea", "country":"IT", "id":"optional"},
{"name":"james", "country":"US", "id":"optional"}
]
}
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
names | Array | Any | आपके परिणामों की सूची |
duration | String | milliseconds("4ms") | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
names(Array) | |||
---|---|---|---|
फ़ील्ड | डेटा प्रकार | मान | विवरण |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
id | Any | Any | optional |
ईमेल से लिंग
एकल ईमेल
एकल ईमेल अनुरोध का मूल उपयोग
GET /api/email/?email=annarobinson@gmail.com&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/email/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
email=annarobinson@gmail.com&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
duration | String | milliseconds "4ms" | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
देश फ़िल्टर के साथ एकल ईमेल
एक देश में एक नाम महिला हो सकता है जबकि किसी अन्य देश में वह पुरुष हो सकता है।
अपनी क्वेरी में देश फ़िल्टर जोड़कर आप उस देश के अनुसार लिंग जानकारी प्राप्त कर सकते हैं।
ISO 3166-1 alpha-2 देश कोड देखें।
* यदि दिए गए देश फ़िल्टर के साथ कोई परिणाम नहीं मिलता है, तो हम वैश्विक नाम परिणाम प्रदान करेंगे।
GET /api/email/?email=annarobinson@gmail.com&country=US&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/email/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
email=annarobinson@gmail.com&country=US&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
duration | String | milliseconds "4ms" | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
एकाधिक ईमेल
आप एक ही बार में कई ईमेल्स का अनुरोध कर सकते हैं। अधिकतम सीमा 50 है।
GET /api/email/?email[]=annarobinson@gmail.com&email[]=jameswhite@gmail.com&key=<YourAPIkey> HTTP/1.1
Host: api.genderapi.io
POST /api/email/ HTTP/1.1
Host: api.genderapi.io
Content-Type: application/x-www-form-urlencoded
email=annarobinson@gmail.com&email=jameswhite@gmail.com&key=<YourAPIkey>
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
names | Array | Any | आपके परिणामों की सूची |
duration | String | milliseconds("4ms") | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
names(Array) | |||
---|---|---|---|
फ़ील्ड | डेटा प्रकार | मान | विवरण |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
देश फ़िल्टर के साथ एकाधिक ईमेल
एक देश में एक नाम महिला हो सकता है जबकि किसी अन्य देश में वह पुरुष हो सकता है।
अपनी क्वेरी में देश फ़िल्टर जोड़कर आप उस देश के अनुसार लिंग जानकारी प्राप्त कर सकते हैं।
ISO 3166-1 alpha-2 देश कोड देखें।
* यदि दिए गए देश फ़िल्टर के साथ कोई परिणाम नहीं मिलता है, तो हम वैश्विक नाम परिणाम प्रदान करेंगे।
* आप एक ही बार में कई ईमेल्स का अनुरोध कर सकते हैं। अधिकतम सीमा 50 है।
POST /api/email/multi/country HTTP/1.1
Host: api.genderapi.io
Content-Type: application/json
{
"key":"<YourAPIkey>",
"data":[
{"email":"Andreawhite@mail.com", "country":"DE", "id":"optional"},
{"email":"andreabrown@gmail.com", "country":"IT", "id":"optional"},
{"email":"jamesblack@yandex.com", "country":"US", "id":"optional"}
]
}
अपनी प्रोग्रामिंग भाषा चुनें
प्रतिक्रिया
फ़ील्ड | डेटा प्रकार | मान | विवरण |
---|---|---|---|
status | Boolean | true,false | यदि false है, तो कृपया त्रुटि कोड्स की जाँच करें। |
used_credits | Integer | Any | हालिया अनुरोध पर उपयोग किए गए क्रेडिट्स की संख्या |
remaining_credits | Integer | Any | आपके पैकेज में शेष क्रेडिट्स की संख्या |
expires | Integer | Any | आपके पैकेज की समाप्ति तिथि (टाइमस्टैम्प में सेकंड के रूप में) |
names | Array | Any | आपके परिणामों की सूची |
duration | String | milliseconds("4ms") | सर्वर पर आपके अनुरोध का प्रोसेसिंग समय |
names(Array) | |||
---|---|---|---|
फ़ील्ड | डेटा प्रकार | मान | विवरण |
q | String | Any | आपकी क्वेरी |
name | String | Any | मिला हुआ नाम |
gender | enum[String] | ["male","female","null"] | लिंग का परिणाम |
country | enum[String] | ["US","DE","FR","IT",...] | सबसे अधिक पाया गया देश |
total_names | Integer | Any | नमूनों की संख्या |
probability | Integer | 50 - 100 | परिणाम की प्रतिशत संभावना |
id | Any | Any | Optional |