FREQUENTLY ASKED QUESTIONS

WHAT ABOUT THE NEW GENERAL DATA PROTECTION REGULATION (GDPR)?

All Gender-API.com services are in full compliance with the GDPR. We provide a Data Processing Agreement (DPA), which enables you to comply with your GDPR obligations. You can request this agreement here in your account. A sample agreement can be downloaded here. Also, you can find more information, how we protect your data here.

WHAT HAPPENS IF A NAME CAN BE MALE AS WELL AS FEMALE?

If you can provide a country code or specific territory in your query, we can guarantee a significant improve in detecting the right gender. For example: While Andrea is male in Italy, Andrea is a female name in Germany and can even be both in the US. In this case, we provide an accuracy value in the query result, ranging between 0 and 100. It tells you how certain we are in having detected the right gender. If you think the value is too low, you can still ask your user to provide the right gender themselves. In most countries, however, we can determine the correct gender in over 94% of cases.

HOW DO YOU GATHER THE DATA?

To provide the highest possible accuracy, we combine data from multiple sources. The main sources for new records are publicly available data, governmental data and manual additions/corrections. Based on the source of a new name, the name may have to be verified by a second source before it is added to our list. For example, if we add a name from publicly available data, this name may need a second verification, like a manual confirmation, before it is finally added to our database.

HOW MANY NAMES DO YOU HAVE STORED IN YOUR DATABASE?

Our database contains 6,084,389 validated names from 191 different countries. All over the world we store 41,758,628 unique names. On an average we analyze about 10,000,000 datasets per month to improve the quality of our results.

WHICH COUNTRIES ARE SUPPORTED?

The API fully supports 191 countries. Full support means that we collected at least 1 names in this respective country. However, in most countries our dataset is much larger. Take a look at the following table to learn more about how many names we support in which country. Keep in mind that if we do not provide a suitable support for a country ourselves, you can still crawl the requested names against the entire dataset to get an adequate result.
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

I HEARD ABOUT YOUR EMAIL API. WHAT EXACTLY IS THIS?

Our email API can extract names from email addresses and provide the appropriate gender to this respective address. This can help you to personalize your emailings with a proper salutation. For example, from the email address "marie.johnson@gmail.com", API will extract the name "Marie" and determine the correct gender, which is "female". For details please take a look at our API Docs.

I HAVE A HUGE AMOUNT OF DATA. CAN I BULK UPLOAD A CSV FILE?

As a registered user you can upload any CSV file containing a first name column. For a better determination result, you can optionally add a country column to your dataset. While it is not necessary to specifically name the columns, our assistant guides you through the process by letting you choose which column contains which token, first name or country included. The feature is located within your account. Processed records will be charged like requests so that you can upload a CSV file with up to 500 entries for free every month. The CSV bulk upload requires a Gender-API.com account. For reasons of data protection, uploaded files will be automatically deleted after one year.

HOW IS THE CSV FILE TO BE FORMATTED?

We support CSV files created on Windows, MacOS, or Linux. In addition, we support files with delimiters like ";", "," or a tab. The enclosure char must be a ". Furthermore, you can upload multi-line CSV files with a maximum of 10,000,000 rows and 301MB. We recommend using a UTF-8 formatted CSV file with a semicolon as the delimiter to achieve the best results possible. Otherwise, the CSV file can contain further, arbitrary rows, which will also be included in the output file. The file must have at least one column with first names only or a column with full names. Click here to download a sample file. Please create a Gender-API.com account to upload a CSV file.

CAN I UPLOAD AN EXCEL FILE?

You can upload Excel files with up to 300,000 rows. For larger datasets, please use our CSV file upload. We support .xlsx files with a single sheet. If you upload a file with more than one sheet, only the first will be processed. The first row in your sheet must contain the column names. The file must contain at least one column with first names, the country column is optional. For reasons of data protection, uploaded files will be automatically deleted after one year. Download sample file here. Example:
Excel Example

DO YOU PROVIDE ANY LIBRARIES FOR PROGRAMMING LANGUAGES?

Due to the simplicity of our API, we do not provide a lib for any programming language, except the jQuery Plugin. Most languages support a json parser out-of-the-box and for almost every other language, there is already an external lib you can use. Take a look at our coding examples to get started with using the API:

First install our library with 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

See full client documentation here:

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

First install our library with npm:

See full client documentation here:

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

First install our library with npm:

See full client documentation here:

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

Download A Sample Project Here:

Documentation:

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

HOW DO REQUESTS GET COUNTED?

Every account will be recharged to 500 credits on the first day of every month if there are less than this number of credits left. Only if a result is found, the request will be counted. One credit will be charged for each request. If multiple names are requested in one query, each name will be counted as a single request.

HOW CAN I BUY MORE CREDITS?

You can choose between either a subscription plan or one-time-payment. One-time-payment is recommended, if you want to process a large CSV file or if you prefer to use your credits on a irregular basis. You can charge your account with the required amount of credits at any time. Credits bought with one-time-payment can be used within one year. If you prefer to sign up for a subscription plan, your account will be refilled to the selected amount of credits every month. Subscriptions can be changed or canceled at any time.
Chat
We use cookies and similar technologies to recognize your repeat visits and preferences, as well as to measure the effectiveness of campaigns and analyze traffic.
You can learn more about which cookies we use or edit them here.