FAQ - OFT GESTELLTE FRAGEN

WAS PASSIERT, WENN EIN NAME SOWOHL MäNNLICH, ALS AUCH WEIBLICH SEIN KANN?

Die Genauigkeit kann z.B. durch das Hinzufügen eines Country Codes zu Ihrem Query erhöht werden. Ist in Italien z.B. Andrea männlich ist dieser Name im Deutschen weiblich. Kann der Name aber z.B. in einem Land sowohl männlich als auch weiblich sein, geben wir Ihnen eine Genauigkeit mit Ihrem Query zurück. Diese kann zwischen 0 und 100 liegen und sagt aus, wie sicher wir uns sind, das richtige Geschlecht ermittelt zu haben. Wenn Ihnen dieser Wert zu niedrig ist, können Sie Ihren Nutzer immer noch nach seinem Geschlecht ode r Anrede fragen. In den meisten Ländern können wir mit einer Sicherheit von über 94 % das richtige Geschlecht bestimmen.

WIE WERDEN DIE DATEN GESAMMELT?

Um eine möglichst hohe Qualität zu gewährleisten kombinieren wir die Daten von mehreren Datenquellen. Wir nutzen öffentlich von Staaten zur Verfügung gestellte Daten und kombinieren diese mit Daten, die wir aus sozialen Netzwerken sammeln. Jeder Name muss aus verschiedenen Quellen verifiziert werden, bevor er in unseren Index mit aufgenommen wird.

WIE VIELE NAMEN HABT IHR GESAMT GESPEICHERT?

Unsere Datenbank enthält 1,877,786 validierte Namen aus 178 unterschiedlichen Ländern. Über die gesamte Welt gesehen haben wir 811,428 eindeutige Namen gespeichert. Im Durchschnitt analysieren wir um die 10,000,000 Millionen Datensets um unsere Qualität der Ergebnisse zu verbessern.

WELCHE LäNDER WERDEN UNTERSTüTZT?

Voll unterstützt werde 178 Länder. Das bedeutet, dass wir für diese Länder mindestens 300 Namen in unserer Datenbank haben. Für viele Länder haben wir aber deutlich mehr eindeutige Namen in unserer Datenbank. In folgender Tabelle finden Sie eine Übersicht, welche Länder wir mit wie vielen Namen unterstützten. Bitte beachten Sie, dass wenn wir ein für ein Land noch wenige Datensätze haben es jederzeit möglich ist, die komplette Datenbank nach diesen Namen zu durchsuchen.

1.
Afghanistan
1,931
2.
Albania
5,739
3.
Algeria
22,075
4.
Andorra
686
5.
Angola
7,630
6.
Argentina
9,867
7.
Armenia
1,453
8.
Aruba
124
9.
Australia
9,153
10.
Austria
10,089
11.
Azerbaijan
4,548
12.
Bahamas
487
13.
Bahrain
3,918
14.
Bangladesh
10,096
15.
Barbados
388
16.
Belarus
3,015
17.
Belgium
26,299
18.
Belize
270
19.
Benin
4,253
20.
Bermuda
106
21.
Bhutan
160
22.
Bolivia
1,543
23.
Bosnia and Herzegovina
3,606
24.
Botswana
2,080
25.
Brazil
49,540
26.
Brunei
518
27.
Bulgaria
4,668
28.
Burkina Faso
2,963
29.
Burundi
754
30.
Cambodia
2,044
31.
Cameroon
8,445
32.
Canada
14,461
33.
Cape Verde
1,656
34.
Central African Republic
114
35.
Chad
378
36.
Chile
5,962
37.
China
23,804
38.
Colombia
13,446
39.
Comoros
410
40.
Congo - Brazzaville
3,929
41.
Congo - Kinshasa
1,150
42.
Costa Rica
2,305
43.
Croatia
3,031
44.
Cuba
1,199
45.
Cyprus
3,700
46.
Czech Republic
14,758
47.
Côte d’Ivoire
13,944
48.
Denmark
6,288
49.
Djibouti
1,450
50.
Dominican Republic
3,769
51.
Ecuador
4,237
52.
Egypt
14,220
53.
El Salvador
2,818
54.
Equatorial Guinea
673
55.
Estonia
2,153
56.
Ethiopia
3,286
57.
Faroe Islands
120
58.
Fiji
842
59.
Finland
4,843
60.
France
109,569
61.
French Guiana
802
62.
French Polynesia
315
63.
Gabon
2,638
64.
Gambia
906
65.
Georgia
1,491
66.
Germany
48,639
67.
Ghana
8,237
68.
Gibraltar
377
69.
Greece
11,927
70.
Greenland
160
71.
Grenada
119
72.
Guadeloupe
646
73.
Guam
280
74.
Guatemala
2,183
75.
Guernsey
152
76.
Guinea
1,036
77.
Guinea-Bissau
103
78.
Guyana
308
79.
Haiti
779
80.
Honduras
1,480
81.
Hong Kong SAR China
5,980
82.
Hungary
10,413
83.
Iceland
1,458
84.
India
84,867
85.
Indonesia
56,287
86.
Iran
8,946
87.
Iraq
8,614
88.
Ireland
6,339
89.
Isle of Man
151
90.
Israel
8,577
91.
Italy
62,370
92.
Jamaica
1,509
93.
Japan
21,488
94.
Jersey
418
95.
Jordan
5,216
96.
Kazakhstan
4,031
97.
Kenya
8,838
98.
Kuwait
9,498
99.
Kyrgyzstan
1,349
100.
Laos
718
101.
Latvia
1,967
102.
Lebanon
7,814
103.
Lesotho
530
104.
Liberia
656
105.
Libya
2,373
106.
Liechtenstein
163
107.
Lithuania
2,393
108.
Luxembourg
2,554
109.
Macedonia
3,379
110.
Madagascar
2,988
111.
Malawi
1,071
112.
Malaysia
23,199
113.
Maldives
725
114.
Mali
2,930
115.
Malta
2,101
116.
Martinique
559
117.
Mauritania
889
118.
Mauritius
3,809
119.
Mayotte
221
120.
Mexico
17,581
121.
Micronesia
149
122.
Moldova
1,932
123.
Monaco
510
124.
Mongolia
687
125.
Montenegro
954
126.
Morocco
27,567
127.
Mozambique
4,547
128.
Myanmar [Burma]
3,796
129.
Namibia
2,076
130.
Nepal
3,169
131.
Netherlands
32,069
132.
New Caledonia
314
133.
New Zealand
3,322
134.
Nicaragua
1,320
135.
Niger
1,163
136.
Nigeria
45,897
137.
Norway
6,904
138.
Oman
6,481
139.
Pakistan
12,462
140.
Palestinian Territories
2,279
141.
Panama
1,847
142.
Papua New Guinea
741
143.
Paraguay
1,296
144.
Peru
7,491
145.
Philippines
18,493
146.
Poland
12,829
147.
Portugal
22,583
148.
Puerto Rico
2,426
149.
Qatar
5,343
150.
Romania
15,177
151.
Russia
26,885
152.
Rwanda
2,108
153.
Réunion
3,313
154.
Saint Helena
1,196
155.
Saint Lucia
262
156.
San Marino
274
157.
Saudi Arabia
34,262
158.
Senegal
9,029
159.
Serbia
6,641
160.
Seychelles
453
161.
Sierra Leone
672
162.
Singapore
9,822
163.
Slovakia
5,190
164.
Slovenia
2,894
165.
Solomon Islands
117
166.
Somalia
644
167.
South Africa
27,272
168.
South Korea
26,525
169.
Spain
144,136
170.
Sri Lanka
6,281
171.
Sudan
3,897
172.
Suriname
296
173.
Swaziland
440
174.
Sweden
15,773
175.
Switzerland
20,442
176.
Syria
3,721
177.
São Tomé and Príncipe
189
178.
Taiwan
17,053
179.
Tajikistan
612
180.
Tanzania
4,422
181.
Thailand
48,386
182.
Timor-Leste
182
183.
Togo
3,073
184.
Trinidad and Tobago
1,038
185.
Tunisia
12,863
186.
Turkey
57,586
187.
Turkmenistan
484
188.
U.S. Virgin Islands
223
189.
Uganda
5,729
190.
Ukraine
10,343
191.
United Arab Emirates
12,963
192.
United Kingdom
54,684
193.
United States
87,041
194.
Uruguay
1,616
195.
Uzbekistan
1,848
196.
Venezuela
9,005
197.
Vietnam
16,585
198.
Western Sahara
176
199.
Yemen
3,343
200.
Zambia
1,964
201.
Zimbabwe
2,584

WIR HABEN VON IHRER E-MAIL API GEHöRT, WAS MACHT DIESE GENAU?

Unsere E-Mail-API können Namen von E-Mail-Adressen zu extrahieren und liefern die entsprechende Geschlechter auf diese jeweilige Adresse. Dies kann Ihnen helfen, Ihre E-Mailings mit einer richtigen Anrede personalisieren. Beispielsweise aus der E-Mail-Adresse “marie.johnson@gmail.com”, API wird den Namen “Marie” zu extrahieren und zu bestimmen, den richtigen Geschlecht, die “weiblich” ist. Für Einzelheiten wenden Sie sich bitte werfen Sie einen Blick auf unsereAPI Docs .

ICH HABE EINE GROßE MENGE AN DATENSäTZEN. KANN ICH DIESE GESAMMELT ALS CSV DATEI HOCH LADEN?

Als registrierter Nutzer können Sie jede beliebige CSV Dateien hochladen, welche mindestens eine Spalte mit dem Vornamen enthält. Um ein besseres Ergebnis zu erreichen, können sie optional eine Spalte mit dem Herkunftsland angeben. Es ist nicht nötig, diese Spalten speziell zu benennen, unser Assistent lässt sie die Zuordnung selbst wählen. Sie finden das CSV Upload Feature innerhalb Ihres Accounts. Verarbeitete Datenzeilen werden wie Anfragen an die API berechnet. Dadurch ist es möglich, dass sie Dateien mit bis zu 500 Zeilen pro Monat kostenlos hochladen können. Das CSV Upload Feature benötigt zwingend einen Gender-API.com Account.

WIE SOLLTE DIE CSV DATEI FORMATIERT SEIN?

Wir unterstützen CSV Dateien, die mit Windows, Mac OSX oder Linux erstellt wurden. Weiterhin unterstützen wir Dateien mit ";", "," oder Tab als Trennzeichen. Strings mit Leerzeichen sollten mit einem "-Zeichen umschlossen sein. Es werden außerdem auch CSV Dateien mit mehrzeiligen Datensätzen unterstützt. Es sind maximal 10,000,000 Datensätze und 200MB pro Datei möglich. Um das bestmögliche Ergebnis zu erzielen, empfehlen wir, die CSV im UTF-8 Format zu speichern. Die Datei sollte mindestens eine Spalte mit Vornamen enthalten. Klicken Sie hier um eine Beispiel-Datei herunter zu laden. Bitte erstellen sie einen Gender-API.com Account um eine CSV Datei hochladen zu können.

KANN ICH EXCEL DATEIEN HOCHLADEN?

Es können Excel Dateien mit bis zu 100.000 Zeilen hochgeladen werden. Für noch größere Datensets benutze bitte unseren CSV Datei Upload. Wir unterstützen .xlsx Dateien mit einem Reiter. Wenn Ihre Excel Datei mehr als einen Reiter enthält, wird nur die erste Seite verarbeitet. Die erste Zeile in der Tabelle muss die Spaltennamen enthalten. Die Datei muss mindestens eine Spalte mit Vornamen besitzen, die Länderspalte ist optional. Beispieldatei hier herunterladen. Beispiel:
Excel Beispiel

ICH HABE EINEN BUG GEFUNDEN, WAS NUN?

Wir freuen uns über jede Hilfe. Haben Sie einen Fehler gefunden, können Sie diesen unter contact gender-api.com melden. Wir werden versuchen, diesen schnellstmöglich zu beheben.

GIBT ES BIBLIOTHEKEN FüR PROGRAMMIERSPRACHEN?

Wegen der Einfachheit unserer Schnittstelle bieten wir neben unserem jQuery Plugin keine Bibliotheken an. Die meisten Programmiersprachen bieten bereits einen JSON Parser bzw. gibt es eine externe Bibliothek, die dieses bereits anbietet. Bitte schauen Sie sich unsere Programmierbeispiele an, um mit der Nutzung unserer API zu beginnen:

PHP with Composer

Command line

$ composer require gender-api/client


<?php

use GenderApi\Client as GenderApiClient;


try {

$apiClient = new GenderApiClient('insert your API key');

$name = $apiClient->getByFirstName('elisabeth');


if ($name->genderFound()) {

echo $name->getGender(); // will return "female" (possible values: male, female, unknown)

}


} catch (GenderApi\Exception $e) {

// Name lookup failed due to a network error or insufficient requests left

// See https://gender-api.com/en/api-docs/error-codes

echo 'Exception: ' . $e->getMessage();

}

Link zur Client-Dokumentation auf Github:

https://github.com/markus-perl/gender-api-client

PHP

<?php


function getGender($firstname) {

$myKey = 'insert your server key here';

$data = json_decode(file_get_contents('https://gender-api.com/get?key=' . $myKey . '&name=' . urlencode($firstname)));

return $data->gender;

}


echo getGender('markus'); //Output: male

Java

import java.io.BufferedReader;

import java.io.IOException;

import java.io.InputStreamReader;

import java.net.HttpURLConnection;

import java.net.URL;

import com.google.gson.Gson;

import com.google.gson.JsonObject;


public class Main {


  public static void main(String[] args) {


  try {

    String myKey = "insert your server key here";

    URL url = new URL("https://gender-api.com/get?key=" + myKey + "&name=markus");

    HttpURLConnection conn = (HttpURLConnection) url.openConnection();


    if (conn.getResponseCode() != 200) {

      throw new RuntimeException("Error: " + conn.getResponseCode());

    }


    InputStreamReader input = new InputStreamReader(conn.getInputStream());

    BufferedReader reader = new BufferedReader(input);


    Gson gson = new Gson();

    JsonObject json = gson.fromJson(reader, JsonObject.class);

    String gender = json.get("gender").getAsString();

    System.out.println("Gender: " + gender); // Gender: male

    conn.disconnect();


    } catch (IOException e) {

      e.printStackTrace();

    }

  }

}

Python 3.*

import json

from urllib.request import urlopen


myKey = "insert your server key here"

url = "https://gender-api.com/get?key=" + myKey + "&name=kevin"

response = urlopen(url)

decoded = response.read().decode('utf-8')

data = json.loads(decoded)

print( "Gender: " + data["gender"]); #Gender: male

 

Python 2.*

import json

import urllib2


myKey = "insert your servery key here"

data = json.load(urllib2.urlopen("https://gender-api.com/get?key=" + myKey + "&name=markus"))

print "Gender: " + data["gender"]; #Gender: male

jQuery

// This example makes use of our jQuery Plugin. Click here for more infos.

//add this code to your HTML within the <head> tag

<script type="text/javascript" src="https://gender-api.com/js/jquery/gender.min.js"></script>

//Javascript Code

$('input#firstname').genderApi({key: genderApiClientKey}).on('gender-found', function(e, result) {

  if (result.accuracy >= 60) {

    alert('Gender found: ' + result.gender);

  }

});

WIE WERDEN REQUESTS GEZäHLT?

Ein kostenloser Account wird immer am ersten jedes Monats wieder auf 500 reckest aufgeladen. Nur wenn auch ein Ergebnis gefunden wurde, wird der Request gezählt. Werden mehrere Namen gleichzeitig angefragt wird jeder Name als einzelner Request gezählt.

WIE KANN ICH MEHR REQUESTS KAUFEN?

Sie können entweder zwischen einem Abonnement oder einer Einmal-Aufladung wählen. Einmal-Aufladungen werden empfohlen, wenn sie z.B. eine große CSV Datei hochladen und um das Geschlecht ergänzt haben wollen. Sie können Ihren Account mit der Anzahl der benötigten Anfragen jederzeit aufladen. Die bei einer Einmal-Aufladung erhaltenen Anfragen können innerhalb eines Jahres benutz werden. Wenn sie sich für das Abonnement entscheiden, wird Ihr Account jeden Monat auf die gewählte Anzahl an Anfragen wiederaufgeladen. Abonnements können jederzeit geändert und gekündigt werden

Cookies erleichtern die Bereitstellung unserer Dienste. Mit der Nutzung unserer Seite erklären Sie sich damit einverstanden, dass wir Cookies verwenden.
OK