FAQ - OFT GESTELLTE FRAGEN

SETZT IHR DIE NEUE DATENSCHUTZ-GRUNDVERORDNUNG (DSGVO) UM?

Die neue Europäische Datenschtz-Grundverordnung (DSGVO) trat am 25. Mai 2018 in Kraft. Wir versichern, dass alle Gender-API.com Dienstleistungen in voller Übereinstimmung mit der DSGVO sind. Wir bieten dir eine Datenverarbeitung Vereinbarung (DPA) im Self-Service zum Download an. Diese ermöglicht es dir, deinen DSGVO Verpflichtungen nachzukommen. Du kannst diese Vereinbarung hier in deinem Benutzerkonto beantragen. Eine Muster-Vereinbarung kann hier herunter geladen werden.

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ögliche hohe Genauigkeit zu gewährleisten, kombinieren wir Daten aus verschiedenen Quellen. Die Wichtigsten sind öffentlich zugängliche Daten, Regierungsdaten und manuelle Ergänzungen/Korrekturen. Basierend auf der Quelle eines neuen Namens muss dieser ggf. noch von einer zweiten Quelle überprüft werden, bevor er unserer Liste aufgenommen wird. Wenn wir z. B. einen Namen aus öffentlich verfügbaren Daten hinzufügen, muss dieser Name möglicherweise noch durch eine zweite Überprüfung, z. B. Durch einen manuellen Check, bestätigt werden, bevor er final zu unserer Datenbank hinzugefügt wird.

WIE VIELE NAMEN HABT IHR GESAMT GESPEICHERT?

Unsere Datenbank enthält 6,084,389 validierte Namen aus 191 unterschiedlichen Ländern. Über die gesamte Welt gesehen haben wir 41,758,628 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 191 Länder. Das bedeutet, dass wir für diese Länder mindestens 1 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
15,606
2.
Albania
37,855
3.
Algeria
186,061
4.
American Samoa
967
5.
Andorra
8,183
6.
Angola
121,331
7.
Anguilla
557
8.
Antigua and Barbuda
2,018
9.
Argentina
81,375
10.
Armenia
10,928
11.
Aruba
1,938
12.
Australia
67,745
13.
Austria
82,653
14.
Azerbaijan
29,878
15.
Bahamas
4,463
16.
Bahrain
32,497
17.
Bangladesh
72,281
18.
Barbados
2,821
19.
Belarus
27,172
20.
Belgium
206,720
21.
Belize
2,631
22.
Benin
41,931
23.
Bermuda
1,300
24.
Bhutan
1,578
25.
Bolivia
15,868
26.
Bosnia and Herzegovina
26,433
27.
Botswana
19,275
28.
Brazil
463,906
29.
British Antarctic Territory
441
30.
British Virgin Islands
646
31.
Brunei
7,179
32.
Bulgaria
29,300
33.
Burkina Faso
26,551
34.
Burundi
5,187
35.
Cambodia
15,413
36.
Cameroon
107,753
37.
Canada
107,756
38.
Cape Verde
16,676
39.
Cayman Islands
1,002
40.
Central African Republic
1,600
41.
Chad
5,002
42.
Chile
57,441
43.
China
224,622
44.
Christmas Island
157
45.
Colombia
118,428
46.
Comoros
5,253
47.
Congo - Brazzaville
46,122
48.
Congo - Kinshasa
11,819
49.
Cook Islands
390
50.
Costa Rica
16,234
51.
Croatia
22,842
52.
Cuba
11,657
53.
Cyprus
27,927
54.
Czech Republic
145,562
55.
Côte d’Ivoire
158,486
56.
Denmark
67,274
57.
Djibouti
15,221
58.
Dominica
1,197
59.
Dominican Republic
41,023
60.
Ecuador
43,818
61.
Egypt
128,387
62.
El Salvador
22,485
63.
Equatorial Guinea
9,835
64.
Eritrea
1,147
65.
Estonia
13,962
66.
Ethiopia
22,061
67.
Falkland Islands
228
68.
Faroe Islands
1,318
69.
Fiji
6,133
70.
Finland
37,044
71.
France
1,040,515
72.
French Guiana
7,178
73.
French Polynesia
3,259
74.
Gabon
30,171
75.
Gambia
7,430
76.
Georgia
11,818
77.
Germany
475,461
78.
Ghana
90,254
79.
Gibraltar
2,592
80.
Greece
107,256
81.
Greenland
1,679
82.
Grenada
1,876
83.
Guadeloupe
5,705
84.
Guam
2,476
85.
Guatemala
18,963
86.
Guernsey
1,292
87.
Guinea
8,925
88.
Guinea-Bissau
2,168
89.
Guyana
2,956
90.
Haiti
9,197
91.
Honduras
12,960
92.
Hong Kong SAR China
57,159
93.
Hungary
100,344
94.
Iceland
13,770
95.
India
576,236
96.
Indonesia
501,174
97.
Iran
63,171
98.
Iraq
73,223
99.
Ireland
55,565
100.
Isle of Man
1,168
101.
Israel
59,358
102.
Italy
651,253
103.
Jamaica
13,030
104.
Japan
169,213
105.
Jersey
2,632
106.
Jordan
42,261
107.
Kazakhstan
29,648
108.
Kenya
77,187
109.
Kiribati
965
110.
Kuwait
80,123
111.
Kyrgyzstan
10,028
112.
Laos
9,001
113.
Latvia
15,007
114.
Lebanon
59,767
115.
Lesotho
5,230
116.
Liberia
6,672
117.
Libya
20,377
118.
Liechtenstein
1,720
119.
Lithuania
18,990
120.
Luxembourg
21,292
121.
Macau SAR China
297
122.
Macedonia
20,651
123.
Madagascar
30,055
124.
Malawi
9,391
125.
Malaysia
235,320
126.
Maldives
9,044
127.
Mali
26,030
128.
Malta
15,566
129.
Marshall Islands
1,035
130.
Martinique
4,823
131.
Mauritania
9,228
132.
Mauritius
28,561
133.
Mayotte
3,041
134.
Mexico
164,574
135.
Micronesia
2,640
136.
Moldova
19,365
137.
Monaco
4,305
138.
Mongolia
5,863
139.
Montenegro
6,915
140.
Montserrat
142
141.
Morocco
245,948
142.
Mozambique
56,535
143.
Myanmar [Burma]
34,089
144.
Namibia
18,841
145.
Nauru
270
146.
Nepal
22,397
147.
Netherlands
239,774
148.
Netherlands Antilles
669
149.
New Caledonia
2,775
150.
New Zealand
23,922
151.
Nicaragua
12,067
152.
Niger
13,498
153.
Nigeria
538,945
154.
Niue
116
155.
Norfolk Island
176
156.
North Korea
830
157.
Northern Mariana Islands
1,361
158.
Norway
65,630
159.
Oman
54,230
160.
Pakistan
91,180
161.
Palau
859
162.
Palestinian Territories
13,770
163.
Panama
15,908
164.
Papua New Guinea
7,596
165.
Paraguay
11,525
166.
Peru
89,655
167.
Philippines
203,777
168.
Poland
173,850
169.
Portugal
234,326
170.
Puerto Rico
20,514
171.
Qatar
44,276
172.
Romania
225,758
173.
Russia
257,235
174.
Rwanda
14,756
175.
Réunion
27,763
176.
Saint Barthélemy
120
177.
Saint Helena
14,679
178.
Saint Kitts and Nevis
899
179.
Saint Lucia
2,910
180.
Saint Martin
1,047
181.
Saint Pierre and Miquelon
188
182.
Saint Vincent and the Grenadines
1,206
183.
Samoa
1,114
184.
San Marino
1,915
185.
Saudi Arabia
284,874
186.
Senegal
83,133
187.
Serbia
51,584
188.
Seychelles
9,652
189.
Sierra Leone
6,111
190.
Singapore
93,648
191.
Slovakia
46,872
192.
Slovenia
24,516
193.
Solomon Islands
1,583
194.
Somalia
7,818
195.
South Africa
216,639
196.
South Korea
225,480
197.
Spain
1,599,498
198.
Sri Lanka
45,521
199.
Sudan
32,666
200.
Suriname
3,308
201.
Swaziland
3,975
202.
Sweden
132,666
203.
Switzerland
169,299
204.
Syria
27,304
205.
São Tomé and Príncipe
3,129
206.
Taiwan
153,318
207.
Tajikistan
4,817
208.
Tanzania
38,179
209.
Thailand
488,052
210.
Timor-Leste
2,874
211.
Togo
29,587
212.
Tonga
1,241
213.
Trinidad and Tobago
7,856
214.
Tunisia
96,422
215.
Turkey
569,155
216.
Turkmenistan
3,808
217.
Turks and Caicos Islands
773
218.
Tuvalu
323
219.
U.S. Virgin Islands
2,177
220.
Uganda
45,005
221.
Ukraine
98,432
222.
United Arab Emirates
95,868
223.
United Kingdom
541,448
224.
United States
671,951
225.
Uruguay
12,861
226.
Uzbekistan
12,632
227.
Vanuatu
1,296
228.
Vatican City
194
229.
Venezuela
91,357
230.
Vietnam
114,475
231.
Wallis and Futuna
189
232.
Western Sahara
2,218
233.
Yemen
32,324
234.
Zambia
17,319
235.
Zimbabwe
21,865
236.
Åland Islands
419

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. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht.

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 301MB 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 300.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. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht. 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:

Installier zuerst unsere Library mit Composer:

$ composer require gender-api/client
use GenderApi\Client as GenderApiClient;

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

    // Query a single name
    $lookup = $apiClient->getByFirstName('elisabeth');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // female
    }

    // Query a full name and improve the result by providing a country code
    $lookup = $apiClient->getByFirstNameAndLastNameAndCountry('Thomas Johnson', 'US');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // male
        echo $lookup->getFirstName();   // Thomas
        echo $lookup->getLastName();    // Johnson
    }

} catch (GenderApi\Exception $e) {
    // Name lookup failed due to a network error or insufficient credits
    // 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

Link zur Client-Dokumentation auf Github:

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

Installier zuerst unsere Library mit npm:

Link zur Client-Dokumentation auf Github:

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

Installier zuerst unsere Library mit npm:

Link zur Client-Dokumentation auf Github:

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

Beispielprojekte hier herunterladen:

Dokumentation:

https://github.com/microknights/Gender-API

WIE WERDEN REQUESTS GEZäHLT?

Jedes Konto wird am ersten Tag jedes Monats mit 500 Credits aufgeladen, wenn weniger als diese Anzahl an Guthaben übrig ist. Nur wenn ein Ergebnis gefunden wird, wird die Anfrage gezählt. Ein Credit wird für jede Anfrage berechnet. Wenn mehrere Namen in einer Abfrage angefordert werden, wird jeder Name als einzelne Anfrage gezählt.

WIE KANN ICH MEHR CREDITS KAUFEN?

Du kannst entweder zwischen einem Abonnement oder einer Einmal-Aufladung wählen. Einmal-Aufladungen werden empfohlen, wenn du z.B. eine große CSV Datei hochladen willst um darin das Geschlecht zu Datensätzen zu ergänzen. Du kannst deinen Account mit der Anzahl der benötigten Credits jederzeit aufladen. Die bei einer Einmal-Aufladung erhaltenen Credits können innerhalb eines Jahres benutz werden. Wenn du dich für das Abonnement entscheidest, wird dein Account jeden Monat auf die gewählte Anzahl an Credits wiederaufgeladen. Abonnements können jederzeit geändert und gekündigt werden.
Chat
Wir verwenden Cookies und ähnliche Technologien, um deine wiederholten Besuche und Präferenzen zu erkennen, sowie um die Effektivität von Kampagnen zu messen und den Datenverkehr zu analysieren.
Hier kannst du mehr darüber erfahren, welche Cookies wir verwenden und diese ggf. editieren.