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:

Required Credits: 1
Request
Without country code
GET https://gender-api.com/get?split=theresa%20miller&key=<your api key>
Request
With country code
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<your api key>
Request
Strict mode on
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<your api 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 API 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.

Chat

Cookies

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.