BLOG

OUR SPLIT API LEFT ITS BETA STATE Feb 12, 2017

After a year of testing, our split API left its beta state. The API was constantly improved since we first launched it with some of our biggest customers a year ago. The API can split full names (first and last name) into its parts. If you have a combined field for first and last name on your page, use this API to extract the parts:
GET https://gender-api.com/get?split=theresa%20miller&key=<your private server key>
The request will be returned as:
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","gender":"female","samples":8065,"accuracy":98,"duration":"56ms"}

BULK PROCESS BIG DATASETS WITH OUR EXCEL UPLOAD FEATURE Jan 12, 2017

We added support for Excel files. Upload any CSV or Excel file containing a first name column to your account. For a better determination result, simply add a country column to your dataset. It is not necessary to name the columns accordingly in advance. Our wizzard guides you through the process and lets you choose which column contains which token, first name or country included.

WE ADDED A MONTHLY USAGE STATISTIC TO YOUR ACCOUNT Oct 16, 2016

In September we started to collect information on your data usage and put them into a statistic to give you a detailed view on your monthly usage. To view your usage statistic just sign in to your account. You'll get a detailed view on how many of your requests you used, and how many of them were left at the end of the month.

DOWNLOAD YOUR INVOICES IN YOUR ACCOUNT Jan 10, 2016

It is now possible to download invoices directly in your account. Until now, invoices were sent to you by email. Since many customers lost this email or deleted it accidentally, we decided to add a new navigation point within your account called "Invoices". Here you will find all your newly created invoices.

FULL IPV6 SUPPORT Jan 4, 2015

It’s only a matter of time until IPv6 replaces IPv4 as the standard on the Internet. Gender-API.com supports from this time on native IPv6 access to our services. If your ISP supports the new protocol you will automatically access our site through IPv6.

WE ARE PROUD TO ANNOUNCE A NEW CSV BULK UPLOAD FEATURE Oct 15, 2014

With our new CSV bulk upload feature you can now easily upload up to 1 Million datasets in one single file. 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 1,000 entries for free every month. This sample CSV file:
 firstname;lastname
 Silvia;Miller
 Jonathan;Holmes
 Sophia;Smith
will result in:
 firstname;lastname;ga_gender;ga_accuracy
 Silvia;Miller;female;99
 Jonathan;Holmes;male;100
 Sophia;Smith;female;98

OUR DATABASE GROWS AND GROWS Oct 10, 2014

We are continuously adding more and more datasets to our database. Today, we support more than 140 countries with over 350,000 unique names. All in all, our database contains 5,347,230 datasets. With 68,077 names the United States is our best supported country in the world.

JQUERY PLUGIN AVAILABLE Jul 28, 2014

Our jQuery Plugin provides an intuitive way to implement our API in different online forms. The plugin is hosted on Github. This example demonstrated the basic usage:
$('input#firstname').genderApi({key: genderApiClientKey}).on('gender-found', function(e, result) {
                if (result.accuracy >= 60) {
                    alert('Gender found: ' + result.gender);
                }
            });
Please visit our plugin page for more information and detailed instructions for use.

MULTIPLE NAMES PER QUERY May 25, 2014

We've added support for multiple names per query. You can now query up to 100 names in one single request. To query multiple names simply add then to the url separated by semicolon:
GET https://gender-api.com/get?name=Anna;Jack;Stephen
The result will look like this:
{"name":"anna;jack;stephen","result":[{"name":"anna","gender":"female","samples":51142,"accuracy":98},{"name":"jack","gender":"male","samples":24890,"accuracy":97},{"name":"stephen","gender":"male","samples":26428,"accuracy":100}],"duration":"190ms"}

GENDER-API.COM WENT ONLINE Mar 1, 2014

Since the market was lacking an easy way to deduce the gender from a first name for commercial use, we started our project gender-api.com with a dataset of about 140,000 names in 68 different countries to meet these needs. Our goal is to support the maximum level of variant forms of spelling and to take into account the peculiarities of different countries all over the globe.
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