All Gender-API.com services are in full compliance with the GDPR.
We provide a Data Processing Agreement (DPA), which enables you to comply with your GDPR obligations.
You can request this agreement here in your account. A sample agreement can be downloaded here.
Also, you can find more information, how we protect your data here.
If you can provide a country code or specific territory in your query, we can guarantee a
significant improve in detecting the right gender. For example: While 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. It tells you how certain we are in having detected the right gender. If you think the
value is too low, you can still ask your user to provide the right gender themselves. In most
countries, however, we can determine the correct gender in over 94% of cases.
To provide the highest possible accuracy, we combine data from multiple sources. The main sources for new records are publicly available data,
governmental data and manual additions/corrections. Based on the source of a new name, the name may have to be verified by a second source before it is added to our list.
For example, if we add a name from publicly available data, this name may need a second verification, like a manual confirmation, before it is finally added to our database.
Our database contains 6,084,389 validated names from 191 different countries. All over the world we store 41,758,628 unique names.
On an average we analyze about 10,000,000 datasets per month to improve the quality of our results.
The API fully supports 191 countries. Full support means that we collected at least 1 names
in this respective country. However, in most countries our dataset is much larger. Take a look at the following table to
learn more about how many names we support in which country. Keep in mind that if we do not provide a suitable support for a
country ourselves, you can still crawl the requested names against the entire dataset to get an adequate result.
Our email API can extract names from email addresses and provide the appropriate
gender to this respective address. This can help you to personalize your emailings with a proper salutation.
For example, from the email address "marie.johnson@gmail.com", API will extract the name "Marie" and determine the
correct gender, which is "female".
For details please take a look at our API Docs.
As a registered user you can upload any CSV file containing a first name column.
For a better determination result, you can optionally add a country column to your dataset. 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 500 entries for free every month. The CSV bulk upload requires a Gender-API.com account. For reasons of data protection, uploaded files will be automatically deleted after one year.
We support CSV files created on Windows, MacOS, or Linux.
In addition, we support files with delimiters like ";", "," or a tab. The enclosure char must be a ".
Furthermore, you can upload multi-line CSV files with a maximum of 10,000,000 rows and 301MB.
We recommend using a UTF-8 formatted CSV file with a semicolon as the delimiter to achieve the best results possible.
Otherwise, the CSV file can contain further, arbitrary rows, which will also be included in the output file.
The file must have at least one column with first names only or a column with full names.
Click here to download a sample file. Please create a Gender-API.com account to
upload a CSV file.
You can upload Excel files with up to 300,000 rows. For larger datasets, please use our CSV file upload.
We support .xlsx files with a single sheet. If you upload a file with more than one sheet, only the first will be processed.
The first row in your sheet must contain the column names. The file must contain at least one column with first names, the country column is optional. For reasons of data protection, uploaded files will be automatically deleted after one year. Download sample file here. Example:
Due to the simplicity of our API, we do not provide a lib for any programming language,
except the jQuery Plugin. Most languages support a json parser out-of-the-box and
for almost every other language, there is already an external lib you can use. Take a look at
our coding examples to get started with using the API:
useGenderApi\Clientas GenderApiClient;try{$apiClient=newGenderApiClient('insert your API key');// Query a single name$lookup=$apiClient->getByFirstName('elisabeth');if($lookup->genderFound()){echo$lookup->getGender();// female}// Query a full name and improve the result by providing a country code$lookup=$apiClient->getByFirstNameAndLastNameAndCountry('Thomas Johnson','US');if($lookup->genderFound()){echo$lookup->getGender();// maleecho$lookup->getFirstName();// Thomasecho$lookup->getLastName();// Johnson}}catch(GenderApi\Exception$e){// Name lookup failed due to a network error or insufficient credits// left. See https://gender-api.com/en/api-docs/error-codesecho'Exception: '.$e->getMessage();}
Every account will be recharged to 500 credits on the first day of every month if there are less than this number of credits left.
Only if a result is found, the request will be counted. One credit will be charged for each request.
If multiple names are requested in one query, each name will be counted as a single request.
You can choose between either a subscription plan or one-time-payment.
One-time-payment is recommended, if you want to process a large CSV file or if you prefer to use your credits on a irregular basis.
You can charge your account with the required amount of credits at any time. Credits bought with one-time-payment can be used within one year.
If you prefer to sign up for a subscription plan, your account will be refilled to the selected amount of credits every month.
Subscriptions can be changed or canceled at any time.
This website uses cookies
To improve our website, to personalize content and adverts, to provide social media features,
and to analyze our traffic, we use cookies. We also share information about your use of our site with our social media,
advertising and analytics partners, who may combine it with other information that you’ve provided to them or that they’ve
collected from you during the use of their services. By continuing to use our site, you consent to the use of cookies on this site..
Cookie declaration last updated on 2019-05-01.
Essential Cookies
Essential cookies enable you to navigate the site and to use its services and features. Without these
necessary
cookies, the site will not perform as smoothly as we would like it to and we may not be able to
provide the site or certain services or features.
Cookie
Description
Duration
PHPSESSID
User information
1 week
euCookie
Cookies accepted
permanent
euCookieConfig
Cookie policy settings
permanent
darkMode
Dark mode notice
permanent
sid
Session ID
permanent
Optional Cookies
Optional cookies can be disabled. If they are disabled, some parts of the website may not function properly and other functions
may
not be available.
We use cookies (including third-party cookies) to collect information about visitors'
use of our website. These cookies help us to provide you with the best possible online experience and to constantly
improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA.
By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information
about the use of cookies, click here or "Cookie Settings" at the end of the page.
