BLOG

A NEW VERSION OF OUR API IS AVAILABLE - PART III

In our third announcement, we would like to introduce our next improvement: Enhanced support for variant forms of spelling.

Sometimes customers enjoy writing their names in different ways. A very common way to do this is using Leetspeak to replace chars with similar glyphs.

For example, the name John is written as J0hn.

To enhance support for names spelt like this, we added a new field called name_sanitized to the API response.

This field gives you the name we found and used for genderization after the name was sanitized in different ways.

IMPORTANT UPDATES ABOUT THE GENERAL DATA PROTECTION REGULATION (GDPR)

The new European General Data Protection Regulation (GDPR) goes into effect on May 25, 2018. We can assure you that all Gender-API.com services will be in full compliance with GDPR by this date.

Gender-API.com provides a Data Processing Agreement (DPA), which enables you to comply with your GDPR obligations.

In addition, we have updated our Privacy Policy and General Terms and Conditions to comply with the new requirements of GDPR.

A NEW VERSION OF OUR API IS AVAILABLE - PART I

Good news, during the last couple of months, our team has worked very hard on a full rewrite of our name lookup engine.

We improved so many great details that we couldn't just put them into one single announcement anymore.

So here is our first improvement, we would like to share with you: Reduced split call failure rate.

Our split API is one of our customers' most used features. However, we understand that it can be very tricky to split a full name into its parts.

With the new API version, we are able to reduce the failure rate of all split calls by about 40%. With the old API version, about 90% of the calls returned the correct result. The new version improves this performance to 94% as internal tests show.

To achieve this improvement, we completely refactored our codebase and developed specific micro-services, which can also be more easily improved in the future.

The advancement also includes improved support for countries where Gender-API.com is already heavily in use, for example Germany or the Netherlands. Names with an affix like "Thomas van der Weijden" are now properly resolved into their consisting parts.

WE IMPROVED THE ACCURACY OF OUR EMAIL API BY 30%

During the last few months, we revised and completely redesigned the backend of our email interface in 3 steps. With the new interface it is now possible to break up email addresses that do not have a clearly distinguishable separator between the first and last name. Before the update, names had to be separated by a dot or hyphen for the email address to be properly broken up. With the new interface, email addresses such as kathleenevans44@gmail.com can now be broken up without any problems. How do we do this: We implemented a multi-stage process using machine learning to check the frequency of any possible first and last name combination to provide the best possible result for each case. Internal tests and analysed have shown that result quality improved by more than 30%.
GET https://gender-api.com/get?email=kathleenevans44@gmail.com&key=<your private server key>
The request will be returned as:
{"email":"kathleenevans44@gmail.com","lastname":"evans","mailprovider":"gmail","name":"kathleen","gender":"female","samples":533,"accuracy":99,"duration":"211ms"}

OUR SPLIT API LEFT ITS BETA STATE

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

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

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

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.

WE UPDATE OUR DATASETS ON A REGULAR BASIS

In the last couple of weeks, we added about 400,000 new qualified datasets, including approximately 20,000 Tamil Indian names to our database and we added support for four completely new countries.

FULL IPV6 SUPPORT

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

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

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

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

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

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