API DOCS

Ενοποιημένο API (v2.0)

Αν είσαι προχωρημένος χρήστης με υψηλό όγκο αιτημάτων, μπορείς να αλλάξεις και στον νέο τερματικό σημείο API V2.0. Το ενοποιημένο API προσφέρει πολύ μεγαλύτερη ταχύτητα και μια πιο ανθεκτική διασύνδεση κατά την εκτέλεση ερωτημάτων για πολλαπλά ονόματα σε μία μόνο αίτηση, αλλά είναι λίγο πιο περίπλοκο στην υλοποίηση.
Δες τα έγγραφα του ενοποιημένου API

OpenAPI

Δείτε την τεκμηρίωση API μας στο Swagger

Postman

Εισήγαγε τον ορισμό του [API] μας στο [Postman]
Απλή Χρήση
Τοποθεσία
Τοποθεσία Με IP
Τοποθεσία Με Locale
Ερώτημα Πολλαπλών Ονομάτων
Διεύθυνση Email
Διαχωρισμός Ονόματος και Επώνυμου
Λάβε τη Χώρα Προέλευσης
[Get Stats]
Κωδικοί Σφαλμάτων

ΑΠΛΗ ΧΡΗΣΗ

Αυτός είναι ο πιο εύκολος τρόπος για να ζητήσετε προσδιορισμό φύλου. Κάθε απάντηση είναι κωδικοποιημένη σε JSON:

Απαιτούμενα αιτήματα: 1
Αίτημα
Μικρό Όνομα
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=Andrea&country=IT&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
key String Το κλειδί API σας
Απάντηση
{"name":"diana","name_sanitized":"Diana","gender":"female","samples":523,"accuracy":93,"duration":"41ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέν όνομα με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΤΟΠΙΚΟΠΟΙΗΣΗ

Προσθέστε περισσότερη ακρίβεια στο αίτημά σας κάνοντας το ερώτημά σας πιο συγκεκριμένο γεωγραφικά:

Απαιτούμενα αιτήματα: 1
Αίτημα
Παράδειγμα Ιταλία
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=Andrea&country=IT&key=<το κλειδί api σας>
Αίτημα
Παράδειγμα Γερμανία
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=Andrea&country=DE&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
country String Κωδικός χώρας ISO 3166 ALPHA-2
key String Το κλειδί API σας
Απάντηση
Παράδειγμα Ιταλία
//In Italy, Andrea is male. 
{"name":"andrea","name_sanitized":"Andrea","country":"IT","gender":"male","samples":1068,"accuracy":95,"duration":"15ms","credits_used":1}
Απάντηση
Παράδειγμα Γερμανία
//In Germany, Andrea is female. 
{"name":"andrea","name_sanitized":"Andrea","country":"DE","gender":"female","samples":4089,"accuracy":85,"duration":"33ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέν όνομα με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
country String Υποβληθέντας κωδικός χώρας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Έγκυροι κωδικοί χωρών:

AD
Andorra
AE
United Arab Emirates
AF
Afghanistan
AL
Albania
AM
Armenia
AO
Angola
AR
Argentina
AT
Austria
AU
Australia
AZ
Azerbaijan
BA
Bosnia and Herzegovina
BB
Barbados
BD
Bangladesh
BE
Belgium
BF
Burkina Faso
BG
Bulgaria
BH
Bahrain
BI
Burundi
BJ
Benin
BN
Brunei
BO
Bolivia
BR
Brazil
BS
Bahamas
BW
Botswana
BY
Belarus
BZ
Belize
CA
Canada
CD
Congo - Kinshasa
CG
Congo - Brazzaville
CH
Switzerland
CI
Côte d’Ivoire
CL
Chile
CM
Cameroon
CN
China
CO
Colombia
CR
Costa Rica
CU
Cuba
CV
Cape Verde
CY
Cyprus
CZ
Czech Republic
DE
Germany
DJ
Djibouti
DK
Denmark
DO
Dominican Republic
DZ
Algeria
EC
Ecuador
EE
Estonia
EG
Egypt
EH
Western Sahara
ES
Spain
ET
Ethiopia
FI
Finland
FJ
Fiji
FM
Micronesia
FR
France
GA
Gabon
GB
United Kingdom
GE
Georgia
GF
French Guiana
GH
Ghana
GI
Gibraltar
GL
Greenland
GM
Gambia
GN
Guinea
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Greece
GT
Guatemala
GU
Guam
GY
Guyana
HK
Hong Kong SAR China
HN
Honduras
HR
Croatia
HT
Haiti
HU
Hungary
ID
Indonesia
IE
Ireland
IL
Israel
IN
India
IQ
Iraq
IR
Iran
IS
Iceland
IT
Italy
JE
Jersey
JM
Jamaica
JO
Jordan
JP
Japan
KE
Kenya
KG
Kyrgyzstan
KH
Cambodia
KM
Comoros
KR
South Korea
KW
Kuwait
KZ
Kazakhstan
LA
Laos
LB
Lebanon
LC
Saint Lucia
LI
Liechtenstein
LK
Sri Lanka
LR
Liberia
LS
Lesotho
LT
Lithuania
LU
Luxembourg
LV
Latvia
LY
Libya
MA
Morocco
MC
Monaco
MD
Moldova
ME
Montenegro
MG
Madagascar
MK
Macedonia
ML
Mali
MM
Myanmar [Burma]
MN
Mongolia
MQ
Martinique
MR
Mauritania
MT
Malta
MU
Mauritius
MV
Maldives
MW
Malawi
MX
Mexico
MY
Malaysia
MZ
Mozambique
NA
Namibia
NC
New Caledonia
NE
Niger
NG
Nigeria
NI
Nicaragua
NL
Netherlands
NO
Norway
NP
Nepal
NZ
New Zealand
OM
Oman
PA
Panama
PE
Peru
PF
French Polynesia
PG
Papua New Guinea
PH
Philippines
PK
Pakistan
PL
Poland
PR
Puerto Rico
PS
Palestinian Territories
PT
Portugal
PY
Paraguay
QA
Qatar
RE
Réunion
RO
Romania
RS
Serbia
RU
Russia
RW
Rwanda
SA
Saudi Arabia
SC
Seychelles
SD
Sudan
SE
Sweden
SG
Singapore
SH
Saint Helena
SI
Slovenia
SK
Slovakia
SL
Sierra Leone
SM
San Marino
SN
Senegal
SO
Somalia
SR
Suriname
ST
São Tomé and Príncipe
SV
El Salvador
SY
Syria
SZ
Swaziland
TD
Chad
TG
Togo
TH
Thailand
TJ
Tajikistan
TL
Timor-Leste
TM
Turkmenistan
TN
Tunisia
TR
Turkey
TT
Trinidad and Tobago
TW
Taiwan
TZ
Tanzania
UA
Ukraine
UG
Uganda
US
United States
UY
Uruguay
UZ
Uzbekistan
VE
Venezuela
VI
U.S. Virgin Islands
VN
Vietnam
YE
Yemen
YT
Mayotte
ZA
South Africa
ZM
Zambia
ZW
Zimbabwe

ΤΟΠΙΚΟΠΟΙΗΣΗ - ΧΩΡΑ ΑΠΟ IP

Επίλεξε τη χώρα του πελάτη σου βάσει της διεύθυνσης IP τους:

Απαιτούμενα αιτήματα: 1
Αίτημα
Παράδειγμα με διεύθυνση IP των [US]
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=john&ip=54.201.16.177&key=<το κλειδί api σας>
Αίτημα
Παράδειγμα με διεύθυνση IP της [Germany]
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=tanja&ip=178.27.177.23&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
ip String Έγκυρη διεύθυνση IP
key String Το κλειδί API σας
Απάντηση
Παράδειγμα με διεύθυνση IP των [US]
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":9991,"accuracy":99,"duration":"44ms","credits_used":1}
Απάντηση
Παράδειγμα με διεύθυνση IP της [Germany]
{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"508ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέν όνομα με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
country String Υποβληθέντας κωδικός χώρας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Το Gender-API.com περιλαμβάνει δεδομένα GeoLite2 που δημιουργήθηκαν από τη MaxMind, διαθέσιμα από http://www.maxmind.com.

ΤΟΠΙΚΟΠΟΙΗΣΗ - ΧΩΡΑ ΜΕ ΒΑΣΗ ΤΗ ΓΛΩΣΣΑ ΤΟΥ ΠΕΡΙΗΓΗΤΗ / ΠΕΡΙΟΧΗ

Επίλεξε τη χώρα του πελάτη σου με βάση τη γλώσσα του περιηγητή του:

Απαιτούμενα αιτήματα: 1
Αίτημα
Παράδειγμα με τοπική ρύθμιση των ΗΠΑ
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=john&locale=en_US&key=<το κλειδί api σας>
Αίτημα
Παράδειγμα με μια γερμανική τοποθεσία
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=tanja&locale=de_DE&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
locale String Browser locale
key String Το κλειδί API σας
Απάντηση
Παράδειγμα με τοπική ρύθμιση των ΗΠΑ
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":991,"accuracy":99,"duration":"47ms","credits_used":1}
Απάντηση
Παράδειγμα με μια γερμανική τοποθεσία
{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"99ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέν όνομα με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
country String Υποβληθέντας κωδικός χώρας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΕΡΩΤΗΣΗ ΓΙΑ ΠΟΛΛΑΠΛΑ ΟΝΟΜΑΤΑ

Μερικές φορές είναι απαραίτητο να ανακτούμε πολλαπλά ονόματα με μία ερώτηση:

Απαιτούμενα αιτήματα: 1 πίστωση για κάθε όνομα
Αίτημα
Χωρίς κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=lisa;jess;thomas&multi=true&key=<το κλειδί api σας>
Αίτημα
Με κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Διαχωρισμένη με ερωτηματικό λίστα ονομάτων για αναζήτηση
country String Διαχωρισμένη με ερωτηματικό λίστα κωδικών χωρών. Οι κωδικοί χωρών πρέπει να είναι με την ίδια σειρά όπως και τα ονόματα. Αν δοθεί μόνο ένας κωδικός χώρας, αυτός ο κωδικός θα χρησιμοποιηθεί για όλα τα ονόματα.
multi Boolean (true|false) Εντολή προς το API να επιστρέψει το αποτέλεσμα ως πίνακα
key String Το κλειδί API σας
Απάντηση
Χωρίς κωδικό χώρας
{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}
Απάντηση
Με κωδικό χώρας
{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέντα ονόματα σε πεζά γράμματα. Ο μέγιστος αριθμός ονομάτων είναι περιορισμένος σε 100.
result Array Δες την απάντηση κάτω από το "Simple Usage"
country String Υποβλήθηκε λίστα με κωδικούς χωρών
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΔΙΕΥΘΥΝΣΗ EMAIL

Μπορείς επίσης να αναζητήσεις ένα φύλο χρησιμοποιώντας μια διεύθυνση email που περιέχει ένα όνομα:

Απαιτούμενα αιτήματα: 1
Αίτημα
Χωρίς κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?email=markus.johnson@gmail.com&key=<το κλειδί api σας>
Αίτημα
Με κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?email=jack.meyer@gmail.com&country=US&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
email String Email address
key String Το κλειδί API σας
Απάντηση
Χωρίς κωδικό χώρας
{"email":"markus.johnson@gmail.com","last_name":"Johnson","first_name":"Markus","mail_provider":"gmail","name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"669ms","credits_used":1}
Απάντηση
Με κωδικό χώρας
{"email":"jack.meyer@gmail.com","last_name":"Meyer","first_name":"Jack","mail_provider":"gmail","name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90,"duration":"1011ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
email String Η υποβληθείσα διεύθυνση email
last_name String Το βρέθηκε επώνυμο
first_name String Το βρέθηκε όνομα
mail_provider String Όνομα του παρόχου email
name String Το όνομα βρέθηκε με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
country String Υποβληθέντας κωδικός χώρας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΔΙΑΧΩΡΙΣΜΟΣ ΟΝΟΜΑΤΟΣ ΚΑΙ ΕΠΩΝΥΜΟΥ

Αν χρησιμοποιείς ένα συνδυασμένο πεδίο για το όνομα και το επώνυμο στη σελίδα σου, χρησιμοποίησε αυτό το API για να εξαγάγεις τα μέρη:

Απαιτούμενα αιτήματα: 1
Αίτημα
Χωρίς κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?split=theresa%20miller&key=<το κλειδί api σας>
Αίτημα
Με κωδικό χώρας
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?split=tim%20johnson&country=US&key=<το κλειδί api σας>
Αίτημα
Αυστηρή λειτουργία ενεργοποιημένη
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
split String Πλήρες όνομα
country String Κωδικός χώρας ISO 3166 ALPHA-2
strict Boolean (true|false) Όταν η αυστηρή λειτουργία είναι ενεργοποιημένη, θα επιστρέψουμε null στο πεδίο last_name αν το last_name δεν μπορεί να βρεθεί στη βάση δεδομένων μας. Όταν η αυστηρή λειτουργία είναι απενεργοποιημένη, θα προσπαθήσουμε να εξάγουμε το επώνυμο ακόμα κι αν δεν μπορεί να βρεθεί στη βάση δεδομένων μας
key String Το κλειδί API σας
Απάντηση
Χωρίς κωδικό χώρας
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}
Απάντηση
Με κωδικό χώρας
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}
Απάντηση
Αυστηρή λειτουργία ενεργοποιημένη
{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}
Πεδίο Τύπος Περιγραφή
last_name String Το βρέθηκε επώνυμο
first_name String Το βρέθηκε όνομα
strict Boolean Αληθές αν η αυστηρή λειτουργία είναι ενεργοποιημένη
name String Το όνομα βρέθηκε με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
country String Υποβληθέντας κωδικός χώρας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Παρακαλώ υποδείξτε στους πελάτες σας να εισάγουν τα ονόματά τους με τη μορφή "Όνομα, Επώνυμο", που κάνει την απάντησή μας πιο ακριβή.

[GET STATS]

Με αυτή την κλήση μπορείς να τραβήξεις κάποια στατιστικά για τον λογαριασμό σου:

Απαιτούμενα αιτήματα: 0 αιτήσεις
Αίτημα
GET https://gender-api.io/get-stats?&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
key String Το κλειδί API σας
Απάντηση
{"key":"yourkey","is_limit_reached":false,"remaining_requests":43566,"amount_month_start":90000,"amount_month_bought":100000,"duration":"37ms"}
Πεδίο Τύπος Περιγραφή
key String Το κλειδί API σας
is_limit_reached Boolean Επιστρέφει αληθές αν δεν υπάρχουν άλλες διαθέσιμες αιτήσεις
remaining_requests Integer Υπολογίζει τις υπόλοιπες αιτήσεις
amount_month_start Integer Αιτήσεις που απομένουν στην αρχή του μήνα
amount_month_bought Integer Αιτήματα που αγοράστηκαν αυτόν τον μήνα
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
Λάβε υπ' όψιν:

Αυτό το API endpoint είναι ακόμα πειραματικό. Πράγμα που σημαίνει:

  • μπορεί να μην αποδώσει την αναμενόμενη ποιότητα αποτελεσμάτων σε ορισμένες περιοχές ακόμα
  • η σύνταξη μπορεί να αλλάξει στο μέλλον
  • οι περισσότερες πελάτες δεν υποστηρίζουν ακόμα αυτό το τερματικό σημείο

Λάβε τη Χώρα Προέλευσης

Λάβετε τη χώρα προέλευσης ενός ονόματος:

Απαιτούμενα αιτήματα: 2
Αίτημα
Μικρό Όνομα
play_arrow Δοκίμασε ζωντανά με το codepen.io 
GET https://gender-api.io/get-country-of-origin?name=Markus&key=<το κλειδί api σας>
Πεδίο Τύπος Περιγραφή
name String Όνομα για αναζήτηση
key String Το κλειδί API σας
Απάντηση
{
    "name": "markus",
    "country_of_origin": [
        {
            "countryName": "Finland",
            "country": "FI",
            "probability": 0.74,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Sweden",
            "country": "SE",
            "probability": 0.22,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Other",
            "country": "--",
            "probability": 0.04
        }
    ],
    "name_sanitized": "Markus",
    "gender": "male",
    "samples": 150,
    "accuracy": 99,
    "country_of_origin_map_url": "https://gender-api.io/en/map/37/3da90b0fe64e5102"
    "credits_used": 2,
    "duration": "165ms"
}
Πεδίο Τύπος Περιγραφή
name String Υποβληθέν όνομα με πεζά γράμματα
name_sanitized String Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
gender String Πιθανές τιμές: male, female, unknown
samples Integer Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
accuracy Integer Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σας για το φύλο είναι 100% ακριβή
country_of_origin Array Κορυφαίες 25 χώρες προέλευσης. Δείτε "%sΠλήρης Κατάλογος Πιθανολογούμενων Χωρών%s" για μια λίστα με υποστηριζόμενες χώρες
country_of_origin_map_url String Ένας σύνδεσμος προς έναν χάρτη που εμφανίζει το αποτέλεσμα σε αποδομένη μορφή. Ο χάρτης μπορεί να προσπελαστεί για 10 λεπτά. Για παράδειγμα, μπορείτε να ενσωματώσετε αυτόν τον χάρτη στο προϊόν σας χρησιμοποιώντας ένα [iframe].
duration String Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
credits_used Integer Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα
Στιγμιότυπο Διαδραστικού Χάρτη
Πλήρης λίστα πιθανών χωρών
Κωδικός χώρας Όνομα χώρας Στατιστική Περιοχή Ηπειρωτική Περιοχή
CN China Eastern Asia Asia
IN India Southern Asia Asia
US United States Northern America Americas
ID Indonesia South-eastern Asia Asia
BR Brazil South America Americas
PK Pakistan Southern Asia Asia
NG Nigeria Western Africa Africa
BD Bangladesh Southern Asia Asia
RU Russia Eastern Europe Europe
MX Mexico Central America Americas
JP Japan Eastern Asia Asia
ET Ethiopia Eastern Africa Africa
PH Philippines South-eastern Asia Asia
EG Egypt Northern Africa Africa
VN Vietnam South-eastern Asia Asia
DE Germany Western Europe Europe
CD Democratic Republic of the Congo Middle Africa Africa
IR Iran Southern Asia Asia
TR Turkey Western Asia Asia
TH Thailand South-eastern Asia Asia
GB United Kingdom Northern Europe Europe
FR France Western Europe Europe
IT Italy Southern Europe Europe
TZ Tanzania Eastern Africa Africa
ZA South Africa Southern Africa Africa
MM Myanmar South-eastern Asia Asia
KR South Korea Eastern Asia Asia
CO Colombia South America Americas
KE Kenya Eastern Africa Africa
ES Spain Southern Europe Europe
AR Argentina South America Americas
UA Ukraine Eastern Europe Europe
UG Uganda Eastern Africa Africa
DZ Algeria Northern Africa Africa
SD Sudan Northern Africa Africa
IQ Iraq Western Asia Asia
PL Poland Eastern Europe Europe
CA Canada Northern America Americas
MA Morocco Northern Africa Africa
AF Afghanistan Southern Asia Asia
SA Saudi Arabia Western Asia Asia
PE Peru South America Americas
VE Venezuela South America Americas
UZ Uzbekistan Central Asia Asia
MY Malaysia South-eastern Asia Asia
AO Angola Middle Africa Africa
MZ Mozambique Eastern Africa Africa
NP Nepal Southern Asia Asia
GH Ghana Western Africa Africa
YE Yemen Western Asia Asia
MG Madagascar Eastern Africa Africa
KP North Korea Eastern Asia Asia
AU Australia AustraliaandNew Zealand Oceania
CI Ivory Coast Western Africa Africa
CM Cameroon Middle Africa Africa
TW Taiwan Eastern Asia Asia
NE Niger Western Africa Africa
LK Sri Lanka Southern Asia Asia
RO Romania Eastern Europe Europe
BF Burkina Faso Western Africa Africa
MW Malawi Eastern Africa Africa
ML Mali Western Africa Africa
SY Syria Western Asia Asia
KZ Kazakhstan Central Asia Asia
CL Chile South America Americas
ZM Zambia Eastern Africa Africa
NL Netherlands Western Europe Europe
GT Guatemala Central America Americas
EC Ecuador South America Americas
ZW Zimbabwe Eastern Africa Africa
KH Cambodia South-eastern Asia Asia
SN Senegal Western Africa Africa
TD Chad Middle Africa Africa
SO Somalia Eastern Africa Africa
GN Guinea Western Africa Africa
SD Sudan Northern Africa Africa
RW Rwanda Eastern Africa Africa
TN Tunisia Northern Africa Africa
CU Cuba Caribbean Americas
BE Belgium Western Europe Europe
BJ Benin Western Africa Africa
GR Greece Southern Europe Europe
BO Bolivia South America Americas
HT Haiti Caribbean Americas
BI Burundi Eastern Africa Africa
DO Dominican Republic Caribbean Americas
CZ Czech Republic Eastern Europe Europe
PT Portugal Southern Europe Europe
SE Sweden Northern Europe Europe
AZ Azerbaijan Western Asia Asia
HU Hungary Eastern Europe Europe
JO Jordan Western Asia Asia
BY Belarus Eastern Europe Europe
AE United Arab Emirates Western Asia Asia
HN Honduras Central America Americas
TJ Tajikistan Central Asia Asia
RS Serbia Southern Europe Europe
AT Austria Western Europe Europe
CH Switzerland Western Europe Europe
IL Israel Western Asia Asia
PG Papua New Guinea Melanesia Oceania
TG Togo Western Africa Africa
SL Sierra Leone Western Africa Africa
HK Hong Kong Eastern Asia Asia
BG Bulgaria Eastern Europe Europe
LA Laos South-eastern Asia Asia
PY Paraguay South America Americas
SV El Salvador Central America Americas
LY Libya Northern Africa Africa
NI Nicaragua Central America Americas
LB Lebanon Western Asia Asia
KG Kyrgyzstan Central Asia Asia
TM Turkmenistan Central Asia Asia
DK Denmark Northern Europe Europe
SG Singapore South-eastern Asia Asia
FI Finland Northern Europe Europe
SK Slovakia Eastern Europe Europe
NO Norway Northern Europe Europe
CG Congo Middle Africa Africa
ER Eritrea Eastern Africa Africa
PS Palestine Western Asia Asia
CR Costa Rica Central America Americas
IE Ireland Northern Europe Europe
LR Liberia Western Africa Africa
NZ New Zealand AustraliaandNew Zealand Oceania
CF Central African Republic Middle Africa Africa
OM Oman Western Asia Asia
MR Mauritania Western Africa Africa
HR Croatia Southern Europe Europe
KW Kuwait Western Asia Asia
PA Panama Central America Americas
MD Moldova Eastern Europe Europe
GE Georgia Western Asia Asia
PR Puerto Rico Caribbean Americas
BA Bosnia and Herzegovina Southern Europe Europe
UY Uruguay South America Americas
MN Mongolia Eastern Asia Asia
AM Armenia Western Asia Asia
AL Albania Southern Europe Europe
JM Jamaica Caribbean Americas
LT Lithuania Northern Europe Europe
QA Qatar Western Asia Asia
NA Namibia Southern Africa Africa
BW Botswana Southern Africa Africa
LS Lesotho Southern Africa Africa
GM The Gambia Western Africa Africa
MK Republic of Macedonia Southern Europe Europe
SI Slovenia Southern Europe Europe
GA Gabon Middle Africa Africa
LV Latvia Northern Europe Europe
GW Guinea-Bissau Western Africa Africa
BH Bahrain Western Asia Asia
TT Trinidad and Tobago Caribbean Americas
SZ Swaziland Southern Africa Africa
EE Estonia Northern Europe Europe
TL East Timor South-eastern Asia Asia
GQ Equatorial Guinea Middle Africa Africa
MU Mauritius Eastern Africa Africa
CY Cyprus Western Asia Asia
DJ Djibouti Eastern Africa Africa
FJ Fiji Melanesia Oceania
RE Réunion Eastern Africa Africa
KM Comoros Eastern Africa Africa
BT Bhutan Southern Asia Asia
GY Guyana South America Americas
ME Montenegro Southern Europe Europe
MO Macau Eastern Asia Asia
SB Solomon Islands Melanesia Oceania
LU Luxembourg Western Europe Europe
SR Suriname South America Americas
EH Western Sahara Northern Africa Africa
CV Cape Verde Western Africa Africa
GP Guadeloupe Caribbean Americas
MV Maldives Southern Asia Asia
MT Malta Southern Europe Europe
BN Brunei South-eastern Asia Asia
BS Bahamas Caribbean Americas
MQ Martinique Caribbean Americas
BZ Belize Central America Americas
IS Iceland Northern Europe Europe
BB Barbados Caribbean Americas
PF French Polynesia Polynesia Oceania
GF French Guiana South America Americas
NC New Caledonia Melanesia Oceania
VU Vanuatu Melanesia Oceania
YT Mayotte Eastern Africa Africa
ST Sao Tome and Principe Middle Africa Africa
WS Samoa Polynesia Oceania
LC Saint Lucia Caribbean Americas
JE Guernsey and Jersey Northern Europe Europe
GU Guam Micronesia Oceania
CW Curaçao Caribbean Americas
KI Kiribati Micronesia Oceania
VC Saint Vincent and the Grenadines Caribbean Americas
TO Tonga Polynesia Oceania
GD Grenada Caribbean Americas
FM Federated States of Micronesia Micronesia Oceania
AW Aruba Caribbean Americas
VI United States Virgin Islands Caribbean Americas
AG Antigua and Barbuda Caribbean Americas
SC Seychelles Eastern Africa Africa
IM Isle of Man Northern Europe Europe
AD Andorra Southern Europe Europe
DM Dominica Caribbean Americas
KY Cayman Islands Caribbean Americas
BM Bermuda Northern America Americas
GL Greenland Northern America Americas
AS American Samoa Polynesia Oceania
KN Saint Kitts and Nevis Caribbean Americas
MP Northern Mariana Islands Micronesia Oceania
MH Marshall Islands Micronesia Oceania
FO Faroe Islands Northern Europe Europe
SX Sint Maarten Caribbean Americas
MC Monaco Western Europe Europe
LI Liechtenstein Western Europe Europe
TC Turks and Caicos Islands Caribbean Americas
GI Gibraltar Southern Europe Europe
SM San Marino Southern Europe Europe
VG British Virgin Islands Caribbean Americas
BQ Caribbean Netherlands Caribbean Americas
PW Palau Micronesia Oceania
CK Cook Islands Polynesia Oceania
AI Anguilla Caribbean Americas
WF Wallis and Futuna Polynesia Oceania
NR Nauru Micronesia Oceania
TV Tuvalu Polynesia Oceania
PM Saint Pierre and Miquelon Northern America Americas
MS Montserrat Caribbean Americas
SH Saint Helena Ascension and Tristan da Cunha Western Africa Africa
FK Falkland Islands South America Americas
NU Niue Polynesia Oceania
TK Tokelau Polynesia Oceania
VA Vatican City Southern Europe Europe

ΚΩΔΙΚΟΙ ΣΦΑΛΜΑΤΩΝ
Απάντηση
Error Example Message
{"errno":30,"errmsg":"limit reached"}
errno (Αριθμός Σφάλματος) errmsg (Μήνυμα Σφάλματος) Περιγραφή
10 invalid country code Δες "Έγκυροι κωδικοί χωρών"
11 number of country codes not equal to number of names Η καταμέτρηση ονομάτων δεν ταιριάζει με την καταμέτρηση των κωδικών χωρών
20 name not set Δεν λήφθηκε όνομα από τον διακομιστή
21 too many names Επιτρέπονται μόνο 100 ονόματα ταυτόχρονα
30 limit reached Έχεις φτάσει το όριο αναζητήσεων
40 invalid or missing key Το κλειδί του διακομιστή σου δεν βρέθηκε στη βάση δεδομένων μας
500 unknown error Εσωτερικό σφάλμα διακομιστή
This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.
Συνομιλία