Gender API

Gender API

Keep your registration forms simple. Optimize your conversions and let us determine the gender of your customers.

Response example. If you want to see more check the documentation.

Free Plan $0.00 Monthly Subscribe
50 Requests / Monthly
Free for Lifetime
No Credit Card Required
MOST POPULAR
Starter Plan $7.99 Monthly Subscribe
5,000 Requests / Monthly
Standard Support
Pro Plan $34.99 Monthly Subscribe
35,000 Requests / Monthly
Standard Support
Enterprise Plan $79.99 Monthly Subscribe
100,000 Requests / Monthly
Standard Support
Custom Plan Volume Monthly Contact Us
Any requests volume you need

Gender-API helps you determine whether a first name is more likely to be used by males or females. Optimize your websites and apps. With an easy-to-implement API.

Gender-API helps you determine whether a first name is more likely to be used by males or females. Optimize your websites and apps. With an easy-to-implement API.

Gender-API will determine the gender of your customers by their first name.

Example Request


curl --request POST 
--url 'https://api.apilayer.com/gender/gender/by-first-name' 
--header 'apikey: YOURKEY' 
--data-raw '{"first_name":"Sandra"}'

Gender-API will help you enrich existing records by querying multiple names with a single API call.

Example Request


curl --request POST 
--url 'https://api.apilayer.com/gender/gender/by-first-name' 
--header 'apikey: YOURKEY' 
--data-raw '[{"first_name":"Sandra"},{"first_name":"Jason"}]'

Furthermore, Gender-API lets you localize your lookups. For example, while Andrea is male in Italy, Andrea is a female name in Germany and can even be both in the US. Our API will consider all these possibilities and give you a probability score on how certain we are that the result is correct.

Example Request


curl --request POST 
--url 'https://api.apilayer.com/gender/gender/by-first-name' 
--header 'apikey: YOURKEY' 
--data-raw '{"first_name":"Sandra", "country": "DE"}'

Example Response


{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

Also, the API can split a full name into its parts. If you query a name like ""Theresa Miller"", our API will return the first name, the last name, and the possible gender of this person.

Example Request


curl --request POST 
--url 'https://api.apilayer.com/gender/gender/by-first-name' 
--header 'apikey: YOURKEY' 
--data-raw '{"full_name":"Theresa Miller"}'

Example Response


{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

Use the email API to extract names from an email address:

Example Request


curl --request POST 
--url 'https://api.apilayer.com/gender/gender/by-email-address' 
--header 'apikey: YOURKEY' 
--data-raw '{"email":"[email protected]"}'

Example Response


{
    "input": {
        "email": "[email protected]"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

What happens if a name can be male as well as female?

Depending on your API version or the integration you're using, our endpoints will either return an accuracy or a probability value in the response. The accuracy parameter returns how sure we are that this name is either male or female. The value is calculated by the number of records in our database. For example, if we have 100 samples of a name, 96 are female, and 4 are male, the accuracy is 96% (or a .96 probability). A low accuracy indicates that this name is probably used by multiple genders and cannot be conjugated to a specific gender.

Can there be differences for the same name per country?

While the name 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 (or a probability value between 0 and 1). It tells you how certain we are in having detected the correct gender. You can significantly increase the API's result quality by providing some geographical information about your query. Geographical information can be a country code, the browser's locale, or an IP address.

Which countries are supported?

The API currently supports 191 countries and contains 6,084,389 validated names. For example, you can look up 475,460 names in Germany, 671,968 in the US, or 576,234 in India.