Determine the gender of a first name

Genderize.io determines the gender of a first name. Use the API for analytics, ad targeting, user segmenting etc. It utilizes big datasets of information, from user profiles across major social networks and exposes this data through its API. The response includes a certainty factor as well.

To achieve more qualified guesses, it is also possible to use localization filters to retreive a guess based only on data for a certain country or language. It's recommended to always use a filter if you have the needed data, since naming can rely heavily on demographics.

At the moment, the database contains 216286 distinct names across 79 countries and 89 languages.

The API is free, but limited at 1000 names/day. If you need more requests, you should check out store.genderize.io.

Be sure to check out the use case section as well, to see what other people have done with the API.

All requests are sent to the following base URL using GET.

GET http://api.genderize.io/

Single Usage

An example of genderizing a single name could look like this.

GET https://api.genderize.io/?name=peter

This would render a JSON response like the following. The count represents the number of data entries examined in order to calculate the response.

{"name":"peter","gender":"male","probability":"0.99","count":796}

Multiple Usage

To genderize multiple names at a time, send along an array as the name parameter.

The API is limited to a maximum of 10 names per request

GET https://api.genderize.io/?name[0]=peter&name[1]=lois&name[2]=stevie

Rate Limiting

To keep track of the number of names you have left for a given time period, you should use the HTTP X-Rate headers returned in the response.

X-Rate-Limit-Limit: 1000 // The amount of names in the current time windowX-Rate-Limit-Remaining: 738 // The number of names left in the current time windowX-Rate-Reset: 13829 // Seconds remaining until a new time window opens

Responses and Errors

The API uses four types of HTTP status codes. All responses will be in content-type: application/json; charset=utf-8

Follow along

Genderize is literally improving by the minute. Besides that, i am working to add more data and functionality to the API. Common age, geographical estimates, ethnicity? Things are in the working. Sign up and i'll send you a mail whenever i do major updates.

To get in contact, please use info@genderize.io or the comment thread below.