gender-api-client
Get the gender for any given name. This is a client for the gender-api.com API.
Usage
Really simple:
var gender =
Querying an email address
Instead of a name you can also provide an email address and gender-api.com will try to read any names from it.
var gender =
A list of names
It is also possible to provide an array of names instead of only one. You will then get an object with all the names as keys and the genders as value back.
var gender =
Additional options
There are a few additional options that you can provide:
key
: An API keyip
: This is to determine from where a user iscountry
: Names can have different genders in different countrieslanguage
: Names can have different genders in different languages
Example:
var gender =
API Limitiations
Without using a key you can run 50 requests a day. By registering to their service (for free) you can use 1000 requests a month.
If you need to do more you can buy additional requests.
Running the tests
npm test
(Keep in mind that this does actual requests to the API, especially if you are not registered)