API DOCS

SPLIT FIRST AND LAST NAME

If you use a combined field for first and last name on your page, use this api to extract the parts:

Request
Without country code
GET https://gender-api.com/get?split=theresa%20miller&key=<your private server key>
Request
With country code
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your private server key>
Request
Strict mode on
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<your private server key>
Field Type Description
split String Full name
country String ISO 3166 ALPHA-2 Country Code
strict Boolean (true|false) When the strict mode is enabled, we will return null in the last_name field if the last_name cannot be found in our database. When the strict mode is disabled, we will try to extract the last name even if it cannot be found in our database
key String Your private server key
Response
Without country code
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}
Response
With country code
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}
Response
Strict mode on
{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}
Field Type Description
last_name String The last name found
first_name String The first name found
strict Boolean True if the strict mode is enabled
name String First Name found in lowercase
name_sanitized String The name after we applied our normalizer to it
country String Submitted country code
gender String Possible values: male, female, unknown
samples Integer Number of records found in our database which match your request
accuracy Integer 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 the server needed to process the request
credits_used Integer The amount of credits used for this query

Please indicate your customers enter their names in the form "First Name, Last Name", which makes our response more accurate.

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