FAQ - OFT GESTELLTE FRAGEN

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

Die neue Europäische Datenschtz-Grundverordnung (DSGVO) tritt am 25. Mai 2018 in Kraft. Wir können dir versichern, dass alle Gender-API.com Dienstleistungen in voller Übereinstimmung mit DSGVO bis zu diesem Zeitpunkt sein werden. 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 ewrden.

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,429 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
2,163
2.
Albania
6,429
3.
Algeria
24,724
4.
Andorra
768
5.
Angola
8,546
6.
Argentina
11,051
7.
Armenia
1,627
8.
Aruba
139
9.
Australia
10,251
10.
Austria
11,300
11.
Azerbaijan
5,094
12.
Bahamas
545
13.
Bahrain
4,388
14.
Bangladesh
11,308
15.
Barbados
435
16.
Belarus
3,377
17.
Belgium
29,455
18.
Belize
302
19.
Benin
4,763
20.
Bermuda
119
21.
Bhutan
179
22.
Bolivia
1,728
23.
Bosnia and Herzegovina
4,039
24.
Botswana
2,330
25.
Brazil
55,485
26.
Brunei
580
27.
Bulgaria
5,228
28.
Burkina Faso
3,319
29.
Burundi
844
30.
Cambodia
2,289
31.
Cameroon
9,458
32.
Canada
16,196
33.
Cape Verde
1,855
34.
Central African Republic
128
35.
Chad
423
36.
Chile
6,677
37.
China
26,660
38.
Colombia
15,060
39.
Comoros
459
40.
Congo - Brazzaville
4,400
41.
Congo - Kinshasa
1,288
42.
Costa Rica
2,582
43.
Croatia
3,395
44.
Cuba
1,343
45.
Cyprus
4,144
46.
Czech Republic
16,529
47.
Côte d’Ivoire
15,617
48.
Denmark
7,043
49.
Djibouti
1,624
50.
Dominican Republic
4,221
51.
Ecuador
4,745
52.
Egypt
15,926
53.
El Salvador
3,156
54.
Equatorial Guinea
754
55.
Estonia
2,411
56.
Ethiopia
3,680
57.
Faroe Islands
134
58.
Fiji
943
59.
Finland
5,424
60.
France
122,717
61.
French Guiana
898
62.
French Polynesia
353
63.
Gabon
2,955
64.
Gambia
1,015
65.
Georgia
1,670
66.
Germany
54,475
67.
Ghana
9,225
68.
Gibraltar
422
69.
Greece
13,358
70.
Greenland
179
71.
Grenada
133
72.
Guadeloupe
724
73.
Guam
314
74.
Guatemala
2,445
75.
Guernsey
170
76.
Guinea
1,160
77.
Guinea-Bissau
115
78.
Guyana
345
79.
Haiti
872
80.
Honduras
1,658
81.
Hong Kong SAR China
6,698
82.
Hungary
11,663
83.
Iceland
1,633
84.
India
95,051
85.
Indonesia
63,041
86.
Iran
10,020
87.
Iraq
9,648
88.
Ireland
7,100
89.
Isle of Man
169
90.
Israel
9,606
91.
Italy
69,854
92.
Jamaica
1,690
93.
Japan
24,067
94.
Jersey
468
95.
Jordan
5,842
96.
Kazakhstan
4,515
97.
Kenya
9,899
98.
Kuwait
10,638
99.
Kyrgyzstan
1,511
100.
Laos
804
101.
Latvia
2,203
102.
Lebanon
8,752
103.
Lesotho
594
104.
Liberia
735
105.
Libya
2,658
106.
Liechtenstein
183
107.
Lithuania
2,680
108.
Luxembourg
2,860
109.
Macedonia
3,784
110.
Madagascar
3,347
111.
Malawi
1,200
112.
Malaysia
25,983
113.
Maldives
812
114.
Mali
3,282
115.
Malta
2,353
116.
Martinique
626
117.
Mauritania
996
118.
Mauritius
4,266
119.
Mayotte
248
120.
Mexico
19,691
121.
Micronesia
167
122.
Moldova
2,164
123.
Monaco
571
124.
Mongolia
769
125.
Montenegro
1,068
126.
Morocco
30,875
127.
Mozambique
5,093
128.
Myanmar [Burma]
4,252
129.
Namibia
2,325
130.
Nepal
3,549
131.
Netherlands
35,917
132.
New Caledonia
352
133.
New Zealand
3,721
134.
Nicaragua
1,478
135.
Niger
1,303
136.
Nigeria
51,405
137.
Norway
7,732
138.
Oman
7,259
139.
Pakistan
13,957
140.
Palestinian Territories
2,552
141.
Panama
2,069
142.
Papua New Guinea
830
143.
Paraguay
1,452
144.
Peru
8,390
145.
Philippines
20,712
146.
Poland
14,368
147.
Portugal
25,293
148.
Puerto Rico
2,717
149.
Qatar
5,984
150.
Romania
16,998
151.
Russia
30,111
152.
Rwanda
2,361
153.
Réunion
3,711
154.
Saint Helena
1,340
155.
Saint Lucia
293
156.
San Marino
307
157.
Saudi Arabia
38,373
158.
Senegal
10,112
159.
Serbia
7,438
160.
Seychelles
507
161.
Sierra Leone
753
162.
Singapore
11,001
163.
Slovakia
5,813
164.
Slovenia
3,241
165.
Solomon Islands
131
166.
Somalia
721
167.
South Africa
30,545
168.
South Korea
29,708
169.
Spain
161,432
170.
Sri Lanka
7,035
171.
Sudan
4,365
172.
Suriname
332
173.
Swaziland
493
174.
Sweden
17,666
175.
Switzerland
22,895
176.
Syria
4,168
177.
São Tomé and Príncipe
212
178.
Taiwan
19,099
179.
Tajikistan
685
180.
Tanzania
4,953
181.
Thailand
54,192
182.
Timor-Leste
204
183.
Togo
3,442
184.
Trinidad and Tobago
1,163
185.
Tunisia
14,407
186.
Turkey
64,496
187.
Turkmenistan
542
188.
U.S. Virgin Islands
250
189.
Uganda
6,416
190.
Ukraine
11,584
191.
United Arab Emirates
14,519
192.
United Kingdom
61,246
193.
United States
97,486
194.
Uruguay
1,810
195.
Uzbekistan
2,070
196.
Venezuela
10,086
197.
Vietnam
18,575
198.
Western Sahara
197
199.
Yemen
3,744
200.
Zambia
2,200
201.
Zimbabwe
2,894

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 200.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:

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 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

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

Installier zuerst unsere Library mit npm:

$ npm i gender-api.com-client --save
import {Client as GenderApiClient, ResultSingleName} from "gender-api.com-client";

const genderApiClient = new GenderApiClient("your API key");

try {
    genderApiClient.getByFirstName('theresa', (response: ResultSingleName) => {
      console.log(response.gender); //female
      console.log(response.accuracy); //98
    });
  
    genderApiClient.getByFirstNameAndCountry('john', 'US', (response: ResultSingleName) => {
      console.log(response.gender); //male
      console.log(response.accuracy); //99
    });
}
catch(e) {
  console.log('Error:', e);
}

Link zur Client-Dokumentation auf Github:

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

Installier zuerst unsere Library mit npm:

$ npm i gender-api.com-client --save
try {
    var GenderApi = require('gender-api.com-client');

    var genderApiClient = new GenderApi.Client('your api key');

    genderApiClient.getByFirstName('theresa', function (response) {
        console.log(response.gender); //female
        console.log(response.accuracy); //98
    });

    genderApiClient.getByFirstNameAndCountry('john', 'US', function (response) {
        console.log(response.gender); //male
        console.log(response.accuracy); //99
    });

}
catch(e) {
    console.log('Error:', e);
}

Link zur Client-Dokumentation auf Github:

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

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
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();
    }
  }
}

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 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