API DOCS

SPLIT FIRST AND LAST NAME

If you have a combined field for the first and the 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> 
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your private server key> 
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=1&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"}
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","country":"US","gender":"male","samples":9509,"accuracy":100,"duration":"46ms"}
{"last_name":null,"first_name":"Markus Stefan","strict":true,"name":"markus","gender":"male","samples":8740,"accuracy":99,"duration":"46ms"}

Please hint your customers to enter the name in the form "First Name, Last Name" which makes our response more accurate.

Let's have a look at the generated response:

Key Datatype Description
last_name String The last name found
first_name String The first name found
name String A lowercase representation of the found first name
gender String Possible values: male, female, unknown
samples Integer Number of records found in our database which are matching your request.
accuracy String This value determines the reliability of our database. A value of 100 means that the results on your gender request are 100% accurate.
duration String Time that took the server to process the request.
strict Boolean Shows if the strict mode is enabled. Default: false. If the strict mode is enabled, gender-api will return null in the last_name field if the last_name cannot be found in the database. If the strict mode is disabled, gender-api will try to extract the last name even if it cannot be found in our database.
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