API DOCS

EINFACHE NUTZUNG

Das ist der einfachste Weg, das Geschlecht zu bestimmen. Alle Antworten unseres Servers sind im JSON Format:

GET https://gender-api.com/get?name=Diana&key=<your private server key>

Antwort des Servers:

{"name":"diana","gender":"female","samples":36,"accuracy":100,"duration":"41ms"}

Antwort des Servers im Detail:

Key Datentyp Beschreibung
name String Übergebener Name
gender String Mögliche Antworten: male, female, uknown
samples Integer Anzahl an Einträgen die auf Ihre Anfrage in unserer Datenbank gefunden wurden.
accuracy String Dieser Wert bestimmt, wie sicher wir sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 100 sagt aus, dass wir uns zu 100% sicher sind.
duration String Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln.

LOKALISIERUNG

Fügen Sie Ihrer Anfrage mehr Genauigkeit hinzu, indem sie das Ursprungsland angeben:

GET https://gender-api.com/get?name=Andrea&country=IT&key=<your private server key> 
GET https://gender-api.com/get?name=Andrea&country=DE&key=<your private server key>

Diese Anfragen geben folgende Antworten zurück:

{"name":"andrea","gender":"male","country":"IT","samples":160,"accuracy":97,"duration":"29ms"} //In Italy, Andrea is male.
{"name":"andrea","gender":"female","country":"DE","samples":19,"accuracy":95,"duration":"31ms"} //In Germany, Andrea is female.
Key Datentyp Beschreibung
country String Gültige Ländercodes:

Gültige Ländercodes:

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
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
ES
Spain
ET
Ethiopia
FI
Finland
FJ
Fiji
FR
France
GA
Gabon
GB
United Kingdom
GE
Georgia
GF
French Guiana
GH
Ghana
GI
Gibraltar
GM
Gambia
GN
Guinea
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Greece
GT
Guatemala
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
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
SN
Senegal
SO
Somalia
SV
El Salvador
SY
Syria
SZ
Swaziland
TD
Chad
TG
Togo
TH
Thailand
TJ
Tajikistan
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
VN
Vietnam
YE
Yemen
ZA
South Africa
ZM
Zambia
ZW
Zimbabwe

LOKALISIERUNG - LAND ANHAND DER IP ADRESSE

Wähle das Land des Kunden anhand seiner IP Adresse:

GET https://gender-api.com/get?name=john&ip=54.201.16.177&key=<your private server key> 
GET https://gender-api.com/get?name=tanja&ip=178.27.177.23&key=<your private server key> 
GET https://gender-api.com/get?name=thomas&ip=auto&key=<your private server key>

Diese Anfragen geben folgende Antworten zurück:

{"name":"John","country":"US","gender":"male","samples":4,"accuracy":100,"duration":"38ms"} //Country: US
{"name":"Tanja","country":"DE","gender":"female","samples":10,"accuracy":100,"duration":"36ms"} //Country: Germany.
{"name":"Thomas","country":"DE","gender":"male","samples":13,"accuracy":100,"duration":"39ms"} //Country: Based on the browser IP. Can only be used by the Javascript API.

Gender-API.com enthält GeoLite2 Daten, erstellt von MaxMind: http://www.maxmind.com.

LOKALISIERUNG - AUSWAHL DES LANDES ANHAND DER BROWSERSPRACHE

Wählt das Land anhand der Browser Locale des Nutzers:

GET https://gender-api.com/get?name=john&language=en-US&key=<your private server key> 
GET https://gender-api.com/get?name=tanja&language=de-DE&key=<your private server key> 
GET https://gender-api.com/get?name=thomas&language=auto&key=<your private server key>

Diese Anfragen geben folgende Antworten zurück:

{"name":"John","country":"US","gender":"male","samples":4,"accuracy":100,"duration":"38ms"} //Country: US
{"name":"Tanja","country":"DE","gender":"female","samples":10,"accuracy":100,"duration":"36ms"} //Country: Germany.
{"name":"Thomas","country":"DE","gender":"male","samples":13,"accuracy":100,"duration":"39ms"} //Country: Based on the browser language. Can only be used by the Javascript API.

ERWEITERTE BENUTZUNG

Manchmal ist es nötig, mehrere Namen mit einem einzigen Query abzuarbeiten:

GET https://gender-api.com/get?name=Anna;Jack;Stephen&key=<your private server key>

Antwort des Servers:

{"name":"Anna;Jack;Stephen","result":[
            {"name":"Anna","gender":"female","samples":211,"accuracy":97},
            {"name":"Jack","gender":"male","samples":105,"accuracy":100},
            {"name":"Stephen","gender":"male","samples":48,"accuracy":100}
            ],"duration":"42ms"}

Antwort des Servers im Detail:

Key Datentyp Beschreibung
name String Übergebene Namen. Die maximale Anzahl an gleichzeitig übergeben Namen ist begrenzt auf 100.
result Array Siehe generierte Antwort unter "EINFACHE NUTZUNG".
duration String Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln.

Bitte beachte: Werden mehrere Namen mit einem Request angefragt, wird jeder Name wie ein einzelner Request gezählt.

E-MAIL ADRESSE

Sie können unsere Datenbank auch nach E-Mail Adressen abfragen, die einen Vornamen enthalten:

GET https://gender-api.com/get?email=markus.p@gmail.com&key=<your private server key> 
GET https://gender-api.com/get?email=jack@gmail.com&country=US&key=<your private server key>

Antwort des Servers:

{"email":"markus.p@gmail.com","name":"markus","gender":"male","samples":150,"accuracy":99,"duration":"44ms"}
{"email":"jack@gmail.com","name":"jack","country":"US","gender":"male","samples":6,"accuracy":67,"duration":"49ms"}

Antwort des Servers im Detail:

Key Datentyp Beschreibung
email String Die übergebene E-Mail Adresse
name String Der gefundene Name in der Adresse
gender String Mögliche Antworten: male, female, uknown
samples Integer Anzahl an Einträgen die auf Ihre Anfrage in unserer Datenbank gefunden wurden.
accuracy String Dieser Wert bestimmt, wie sicher wir sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 100 sagt aus, dass wir uns zu 100% sicher sind.
duration String Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln.

VOR- UND NACHNAME SPLITTEN

Wenn Sie ein kombiniertes Feld für Vor- und Nachname auf Ihrer Seite haben können Sie diese API benutzen um die entsprechenden Teile zu extrahieren:

GET https://gender-api.com/get?split=theresa%20miller&key=<your private server key> 
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your private server key> 
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=1&key=<your private server key>

Antwort des Servers:

{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","gender":"female","samples":8065,"accuracy":98,"duration":"56ms"}
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","country":"US","gender":"male","samples":9509,"accuracy":100,"duration":"46ms"}
{"last_name":null,"first_name":"Markus Stefan","strict":true,"name":"markus","gender":"male","samples":8740,"accuracy":99,"duration":"46ms"}

Bitte geben Sie Ihren Kunden den Hinweis aus, den Namen in der Form "Vorname, Nachname" einzutragen, um das Ergebnis zu verbessern.

Antwort des Servers im Detail:

Key Datentyp Beschreibung
last_name String Der gefundene Nachname
first_name String Der gefundene Vorname
name String Eine kleingeschriebene Darstellung des gefundenen Vornamens
gender String Mögliche Antworten: male, female, uknown
samples Integer Anzahl an Einträgen die auf Ihre Anfrage in unserer Datenbank gefunden wurden.
accuracy String Dieser Wert bestimmt, wie sicher wir sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 100 sagt aus, dass wir uns zu 100% sicher sind.
duration String Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln.
strict Boolean Zeigt an, ob der Strict-Mode aktiviert ist. Standard: false. Wenn der Strict-Mode aktiviert ist wird gender-api null im last_name Feld zurück geben, wenn der Nachname nicht in unserer Datenbank gefunden werden kann. Ist der Strict-Mode deaktiviert versucht gender-api den Nachnamen zu extrahieren, auch wenn dieser nicht in unserer Datenbank gefunden wurde.

STATISTIK ABFRAGEN

Mit diesem Aufruf können Sie einige Statistiken zu Ihrem Account abfragen

GET https://gender-api.com/get-stats?&key=<your private server key>

Antwort des Servers:

{"key":"your private server key","is_limit_reached":false,"remaining_requests":200,"amount_month_start":5000,"amount_month_bought":0,"duration":"48ms"}

Antwort des Servers im Detail:

Key Datentyp Beschreibung
key String Ihr privater Server Key
is_limit_reached Boolean Gibt true zurück, wenn keine Requests mehr vorhanden sind
remaining_requests Integer Anzahl an verbleibender Requests
amount_month_start Integer Vorhandene Requests am Monatsanfang
amount_month_bought Integer Anzahl an Requests die diesen Monat gekauft wurden
duration String Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln.

ERROR CODES

errno errmsg Beschreibung
10 invalid country code Siehe "Gültige Ländercodes"
20 name not set Der eingegangene Request enthielt keinen Namen
21 too many names Es sind nur 100 Namen pro Abfrage erlaubt
30 limit reached Abfragelimit erreicht
40 invalid or missing key Ihr Server Key wurde nicht in der Datenbank gefunden
500 unknown error Interner Server Fehler
Cookies erleichtern die Bereitstellung unserer Dienste. Mit der Nutzung unserer Seite erklären Sie sich damit einverstanden, dass wir Cookies verwenden.
OK