FREQUENTLY ASKED QUESTIONS

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 the data of multiple data sources. We use data from publicly available governmental sources and combine them with data we crawl from social networks, which provides you the best possible matches. Each name has to be verified by different sources to be added to our list.

HOW MANY NAMES DO YOU HAVE STORED IN YOUR DATABASE?

Our database contains 1877782 validated names from 178 different countries. All over the world we store 811424 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 178 countries. Full support means that we collected at least 300 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
1931
2.
Albania
5739
3.
Algeria
22075
4.
Andorra
686
5.
Angola
7630
6.
Argentina
9867
7.
Armenia
1453
8.
Aruba
124
9.
Australia
9152
10.
Austria
10089
11.
Azerbaijan
4548
12.
Bahamas
487
13.
Bahrain
3918
14.
Bangladesh
10096
15.
Barbados
388
16.
Belarus
3015
17.
Belgium
26299
18.
Belize
270
19.
Benin
4253
20.
Bermuda
106
21.
Bhutan
160
22.
Bolivia
1543
23.
Bosnia and Herzegovina
3606
24.
Botswana
2080
25.
Brazil
49540
26.
Brunei
518
27.
Bulgaria
4668
28.
Burkina Faso
2963
29.
Burundi
754
30.
Cambodia
2044
31.
Cameroon
8445
32.
Canada
14461
33.
Cape Verde
1656
34.
Central African Republic
114
35.
Chad
378
36.
Chile
5962
37.
China
23804
38.
Colombia
13446
39.
Comoros
410
40.
Congo - Brazzaville
3929
41.
Congo - Kinshasa
1150
42.
Costa Rica
2305
43.
Croatia
3031
44.
Cuba
1199
45.
Cyprus
3700
46.
Czech Republic
14758
47.
Côte d’Ivoire
13944
48.
Denmark
6288
49.
Djibouti
1450
50.
Dominican Republic
3769
51.
Ecuador
4237
52.
Egypt
14220
53.
El Salvador
2818
54.
Equatorial Guinea
673
55.
Estonia
2153
56.
Ethiopia
3286
57.
Faroe Islands
120
58.
Fiji
842
59.
Finland
4843
60.
France
109569
61.
French Guiana
802
62.
French Polynesia
315
63.
Gabon
2638
64.
Gambia
906
65.
Georgia
1491
66.
Germany
48639
67.
Ghana
8237
68.
Gibraltar
377
69.
Greece
11927
70.
Greenland
160
71.
Grenada
119
72.
Guadeloupe
646
73.
Guam
280
74.
Guatemala
2183
75.
Guernsey
152
76.
Guinea
1036
77.
Guinea-Bissau
103
78.
Guyana
308
79.
Haiti
779
80.
Honduras
1480
81.
Hong Kong SAR China
5980
82.
Hungary
10413
83.
Iceland
1458
84.
India
84865
85.
Indonesia
56287
86.
Iran
8946
87.
Iraq
8614
88.
Ireland
6339
89.
Isle of Man
151
90.
Israel
8577
91.
Italy
62370
92.
Jamaica
1509
93.
Japan
21488
94.
Jersey
418
95.
Jordan
5216
96.
Kazakhstan
4031
97.
Kenya
8838
98.
Kuwait
9498
99.
Kyrgyzstan
1349
100.
Laos
718
101.
Latvia
1967
102.
Lebanon
7814
103.
Lesotho
530
104.
Liberia
656
105.
Libya
2373
106.
Liechtenstein
163
107.
Lithuania
2393
108.
Luxembourg
2554
109.
Macedonia
3379
110.
Madagascar
2988
111.
Malawi
1071
112.
Malaysia
23199
113.
Maldives
725
114.
Mali
2930
115.
Malta
2101
116.
Martinique
559
117.
Mauritania
889
118.
Mauritius
3809
119.
Mayotte
221
120.
Mexico
17581
121.
Micronesia
149
122.
Moldova
1932
123.
Monaco
510
124.
Mongolia
687
125.
Montenegro
954
126.
Morocco
27567
127.
Mozambique
4547
128.
Myanmar [Burma]
3796
129.
Namibia
2076
130.
Nepal
3169
131.
Netherlands
32069
132.
New Caledonia
314
133.
New Zealand
3322
134.
Nicaragua
1320
135.
Niger
1163
136.
Nigeria
45897
137.
Norway
6904
138.
Oman
6481
139.
Pakistan
12462
140.
Palestinian Territories
2279
141.
Panama
1847
142.
Papua New Guinea
741
143.
Paraguay
1296
144.
Peru
7491
145.
Philippines
18493
146.
Poland
12829
147.
Portugal
22583
148.
Puerto Rico
2426
149.
Qatar
5343
150.
Romania
15177
151.
Russia
26885
152.
Rwanda
2108
153.
Réunion
3313
154.
Saint Helena
1196
155.
Saint Lucia
262
156.
San Marino
274
157.
Saudi Arabia
34262
158.
Senegal
9029
159.
Serbia
6641
160.
Seychelles
453
161.
Sierra Leone
672
162.
Singapore
9822
163.
Slovakia
5190
164.
Slovenia
2894
165.
Solomon Islands
117
166.
Somalia
644
167.
South Africa
27272
168.
South Korea
26525
169.
Spain
144136
170.
Sri Lanka
6281
171.
Sudan
3897
172.
Suriname
296
173.
Swaziland
440
174.
Sweden
15773
175.
Switzerland
20442
176.
Syria
3721
177.
São Tomé and Príncipe
189
178.
Taiwan
17053
179.
Tajikistan
612
180.
Tanzania
4422
181.
Thailand
48386
182.
Timor-Leste
182
183.
Togo
3073
184.
Trinidad and Tobago
1038
185.
Tunisia
12863
186.
Turkey
57586
187.
Turkmenistan
484
188.
U.S. Virgin Islands
223
189.
Uganda
5729
190.
Ukraine
10343
191.
United Arab Emirates
12963
192.
United Kingdom
54684
193.
United States
87040
194.
Uruguay
1616
195.
Uzbekistan
1848
196.
Venezuela
9005
197.
Vietnam
16585
198.
Western Sahara
176
199.
Yemen
3343
200.
Zambia
1964
201.
Zimbabwe
2584

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.

HOW IS THE CSV FILE TO BE FORMATTED?

We support CSV files created on Windows, Mac OSX 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 200MB. To achieve the best results possible, we however recommend using a UTF-8 formatted CSV file with semicolon as delimiter. Otherwise, the CSV file can contain further, arbitrary rows which will also be included in the output file. The file must contain at least one column with first names only. Click here to download a sample file. Please create a Gender-API.com account to upload a CSV file.

CAN I UPLOAD A EXCEL SHEET?

You can upload Excel files with up to 100 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. 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:

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

  }

});

HOW DO REQUESTS GET COUNTED?

A free account will be recharged to 500 requests on the first day of every month. Only if a result is found, the request will be actually counted. If multiple names are requested in one query, each name will be counted as a single request.

HOW CAN I BUY MORE REQUESTS?

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 requests on a irregular basis. You can charge your account with the required amount of requests at any time. Requests 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 requests every month. Subscriptions can be changed or canceled at any time.

We use cookies to ensure that we give you the best experience on our website. If you continue to use this site we will assume that you are happy with it.
Got it